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HP-IB Programming 


This document is an introduction to programming your analyzer over the 
Hewlett-Packard Interface Bus (HP-IB). Its purpose is to provide concise 
information about the operation of the instrument under HP-IB control. 

It provides some background information on the HP-IB and a tutorial 
introduction using programming examples to demonstrate the remote 
operation of the analyzer. The examples are provided on two disks that are 
included with the analyzer. Both disks contain the same examples written 
mainly in HP BASIC; only the disk format is different. These programs can 
run on the analyzer’s internal controller (Option 1C2) or on an external 
controller. 


® Example Programs Disk — DOS Format : part number 08712-10019 
e Example Programs Disk — LIF Format: part number 08712-10021 


You should become familiar with the operation of your network analyzer 
before controlling it over HP-IB. This document is not intended to teach 
programming or to discuss HP-IB theory except at an introductory level. 
Related information can be found in the following references. Contact the 
nearest HP sales office for ordering information. A list of HP sales and service 
offices can be found in the “Specifications and Characteristics’ chapter of the 
User’s Guide. 

e Information on making measurements with the analyzer is available in the 
analyzer’s User’s Guide. 

e Information on HP Instrument BASIC is available in the HP Instrument 
BASIC User’s Handbook. 


« Information on HP BASIC programming is available in the manual set for 
he BASIC revision being used. For example: BASIC 7.0 Programming 
Techniques and BASIC 7.0 Language Reference. 


« Information on using the HP-IB is available in the Tutorial Description of 
the Hewlett-Packard Interface Bus (HP literature no. 5021-1927). 
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Introduction to HP-IB Programming 


HP-IB — the Hewlett-Packard Interface Bus — is a high-performance bus 

that allows individual instruments and computers to be combined into 
integrated test systems. The bus and its associated interface operations are 
defined by the IEEE 488.1 standard. The IEEE 488.2 standard defines the 
interface capabilities of instruments and controllers in a measurement system, 
including some frequently used commands. 


HP-IB cables provide the physical link between devices on the bus. There are 
eight data lines on each cable that are used to send data from one device to 
another. Devices that send data over these lines are called Talkers. Listeners 
are devices that receive data over the same lines. There are also five control 
lines on each cable that are used to manage traflic on the data limes and to 
control other interface operations. Controllers are devices that use these 
control lines to specify the talker and listener in a data exchange. When an 
HP-IB system contains more that one device with controller capabilities, 

only one of the devices is allowed to control data exchanges at any given 
time. The device currently controlling data exchanges is called the Active 
Controller. Also, only one of the controller-capable devices can be designated 
as the System Controller, the one device that can take control of the bus 
even if it is not the active controller. The network analyzer can act as a 
talker, listener, active controller or system controller at different times. 


HP-IB addresses provide a way to identify devices on the bus. The active 
controller uses HP-IB addresses to specify which device talks and which 
device listens during a data exchange. This means that each device’s address 
must be unique. A device’s address is set on the device itself, using either a 
front-panel key sequence or a rear-panel switch. 


To set the HP-IB address on the analyzer use the softkeys located in the 
HP-IB menu. The factory default address for the analyzer 
is 16. 
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Introduction to HP-IB Pregramming 


ea EG TS EE TTT 
NOTE 


Throughout this manual, the following conventions are used: 


Square brackets ([ ]) are used to enclose a keyword that is optional or implied when 
programming the command; that is, the instrument will process the command to have the same 
effect whether the option node is omitted or not. 


Parameter types (< >) are distinguished by enclosing the type name in angle brackets. 


A vertical bar ({} can be read as “or” and is used to separate alternative parameter options. 


1-3 


Control Lines 


Bus Structure 


Data Bus 


The data bus consists of eight lines that are used to transfer data from one 
device to another. Programming commands and data sent on these lines is 
typically encoded in the ASCII format, although binary encoding is often used 
to speed up the transfer of large arrays. Both ASCII and binary data formats 
are available to the analyzer. In addition, every byte transferred over HP-IB 
undergoes a handshake to ensure valid data. 


Handshake Lines 


A three-line handshake scheme coordinates the transfer of data between 
talkers and listeners. This technique forces data transfers to occur at the 
speed of the slowest device, and ensures data integrity in multiple listener 
transfers. With most computing controllers and instruments, the handshake is 
performed automatically, which makes it transparent to the programmer. 


The data bus also has five control lines that the controller uses both to send 
bus commands and to address devices: 


IFC Interface Clear. Only the system controller uses this line. 
When this line is true (low) all devices (addressed or not) 
unaddress and go to an idle state. 


ATN Attention. The active controller uses this line to define 
whether the information on the data bus is a command or is 
data. When this line is true (low) the bus is in the command 
mode and the data lines carry bus commands. When this 
line is false (high) the bus is in the data mode and the data 
lines carry device-dependent instructions or data. 
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SRQ 


REN 


EOL 


Introduction to HP-IB Programming 
Bus Structure 


Service Request. This line is set true (ow) when a 

device requests service: the active controller services the 
requesting device. The analyzer can be enabled to pull the 
SRQ line for a variety of reasons. 


Remote Enable. Only the system controller uses this line. 
When this line is set true (ow) the bus is in the remote 
mode and devices are addressed either to listen or talk. 
When the bus is in remote and a device is addressed, the 
device receives instructions from HP-IB rather than from its 
front panel (pressing the Return to Local: softkey returns 
the device to front panel operation). When this line is set 
false (high) the bus and all devices return to local operation. 


End or Identify. This line is used by a talker to indicate the 
last data byte in a multiple byte transmission, or by an 
active controller to initiate a parallel poll sequence. The 
analyzer recognizes the EOI line as a terminator and it pulls 
the EO! line with the last byte of a message output (data, 
markers, plots, prints, error messages). The analyzer does 
not respond to parallel poll. 
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Sending Commands 


Commands are sent over the HP-IB via a controller’s language system, 
such as IBASIC, QuickBASIC or C. The keywords used by a controller to 
send HP-IB commands vary among systems. When determining the correct 
keywords to use, keep in mind that there are two different kinds of HP-IB 
commands: 


« Bus management commands, which control the HP-IB interface. 
e Device commands, which control analyzer functions. 


Language systems usually deal differently with these two kinds of HP-IB 
commands. For example, HP BASIC uses a unique keyword to send each bus 
management command, but always uses the keyword OUTPUT to send device 
commands. 


The following example shows how to send a typical device command: 
OUTPUT 716; "CALCULATE : MARKER : MAXIMUN" 


This sends the command within the quotes (CALCULATE : MARKER :MAXIMUM) 
to the HP-IB device at address 716. If the device is an analyzer, the command 
instructs the analyzer to set a marker tc the maximum point on the data 
trace. 


HP-IB Requirements 


Number of Interconnected 
Devices: 


Interconnection 
Path/Maximum Cable Length: 


Message Transfer Scheme: 


Data Rate: 


Address Capability: 


Multiple Controller Capability: 


15 maximum 


20 meters maximum or 2 meters per device, 
whichever is less. 


Byte serial/ bit parallel asynchronous data 
transfer using a 3-line handshake system. 


Maximum of 1 megabyte per second over 
limited distances with tri-state drivers. 
Actual data rate depends on the transfer rate 
of the slowest device involved. 


Primary addresses: 31 talk, 31 listen. A 
maximum of | talker and 14 listeners at one 
time. 


In systems with more than one controller 
(like the analyzer system), only one can 

be active at a time. The active controller 
can pass control to another controller, but 
only the system controller can assume 
unconditional control. Only one system 
controller is allowed. The system controller 
is hard-wired to assume bus control after a 
power failure. 
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Interface Capabilities 


The analyzer has the following interface capabilities, as defined by the 
IEEE 488.1 standard: 


SH1 full Source handshake capability 

AHI full Acceptor handshake capability 

16 basic Taker, Serial Poll, no Talk Only, unaddress if MLA 
TEO no Extended Talker capability 

4 basic Listener, no Listen Only, unaddress if MTA 

LEC no Extended Listener capability 

SRi full Service Request capability 

Y RL [fot Remora capability 

[et full Device Clear capability 

j + 

C1 System Controller capability 

C2 send IFC and take charge Controller capability 

(63 send REN Controller capability 

ica respond to SRO 
jet send IFC, receive control, pass control, pass contra! to self 
civ? [spe messages, receive control, pass control 

£2 tristate drivers 

m7 full device trigger capability 

PPO Tho parallel poll capability 


1 only when an HP lostrument BASIC program is running 
2 only when an HP instrument BASIC aregram is net running 


Programming Fundamentals 


This section includes specific information for programming your network 
analyzer. It includes how the analyzer interacts with a controller, how data 
is transferred between the analyzer and a controller, and how to use the 
analyzer’s status register structure to generate service requests. 


Controller Capabilities 


The analyzer can be configured as an HP-IB system controller or as 
a talker/listener on the bus. To configure the analyzer, select either 


the System Controller: or the Talker/Listener: softkey in the 
HP-1B menu. 


The analyzer is not usually configured as the system controller unless it is the 
only controller on the bus. This setup would be used if the analyzer only 
needed to control printers or plotters. It would also be used if HP Instrument 
BASIC was being used to control other test equipment. 


When the analyzer is used with another controller on the bus, it is usually 
configured as a talker/listener. In this configuration, when the analyzer is 
passed control it can function as the active controller. 
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Device Clear (DCL) 


Go To Local (GTL) 


Interface Clear (IFC) 


Introduction te HP-I8 Programming 
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Response to Bus Management Commands 


The HP-IB contains an attention (ATN) line that determines whether 

the interface is in command mode or data mode. When the interface is 

in command mode (ATN TRUE) a controller can send bus management 
commands over the bus. Bus management commands specify which devices 
on the interface can talk (send data) and which can listen (receive data). 
They also instruct devices on the bus, cither individually or collectively, to 
perform a particular interface operation. 


This section describes how the analyzer responds to the HP-IB bus 
management commands. The commands themselves are defined by the 
IEEE 488.1 standard. Refer to the documentation for your controller’s 
language system to determine how to send these commands. 


When the analyzer receives this command, it: 


e Clears its input and output queues. 

e Resets its command parser (so it is ready to receive a new program 
message). 

« Cancels any pending *OPC command or query. 


The command does not affect: 


« Front panel operation. 

e Any analyzer operations in progress (other than those already mentioned). 

« Any instrument. settings or registers (although clearing the output queue 
may indirectly affect the Status Byte’s Message Available (MAV) bit). 


This command returns the analyzer to local (front-panel) control. All keys on 
the analyzer’s front-panel are enabled. 


This coramand causes the analyzer to halt all bus activity. It discontinues 
any input or output, although the input and output queues are not cleared. 
If the analyzer is designated as the active controller when this command is 
received, it relinquishes control of the bus to the system controller. If the 
analyzer is enabled to respond to a Serial Poll it becomes Serial Poll disabled. 
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Local Lockout (LLOQ) 


Parallel Poll 


Remote Enable (REN) 


Introduction to HP-IB Programming 
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This command causes the analyzer to enter the local lockout mode, regardless 
of whether it is in the local or remote mode. The analyzer only leaves the 
local lockout mode when the HP-IB’s Remote Enable (REN) line is set FALSE. 


Local Lockout ensures that the analyzer’s remote softkey menu (including the 
Return to LOCAL softkey) is disabled when the analyzer is in the remote 
mode. When the key is enabled, it allows a front-panel operator to return the 
analyzer to local mode, enabling all other front-panel keys. When the key is 
disabled, it does not allow the front-panel operator to return the analyzer to 
local mode. 


The analyzer ignores all of the following parallel poll commands: 


Parallel Poll Configure (PPC). 
Parallel Poll Unconfigure (PPU). 
Parallel Poll Enable (PPE). 
Parallel Poll Disable (PPD). 


REN is a single line on the HP-IB. When it is set TRUE, the analyzer will 
enter the remote mode when addressed to listen. It will remain in remote 
mode until it receives the Go to Local (GTL) cornmand or until the REN line is 
set FALSE. 


When the analyzer is in remote mode and local lockout mode, all front panel 
keys are disabled. When the analyzer is in remote mode but not in local 
lockout mode, all front panel keys are disabled except for the softkeys. The 

remote softkey menu includes seven keys that are available for use bya 
program. The eighth softkey is the Return to ‘LOCAL key which allows a 
front-panel operator to return the analyzer to local mode, enabling all other 
front-panel keys. 


Selected Device Ciear 
(snc) 


Serial Pall 


Take Contral Talker 
(CT) 
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The analyzer responds to this command in the same way that it responds to 
the Device Clear (DCL) command. 


When the analyzer receives this command it: 


e Clears its input and output queues. 

e Resets its command parser (so it is ready to receive a new program 
message). 

e Cancels any pending *OPC command or query. 


The cormmand does not affect: 


e Front-panel operation. 

e Any analyzer operations in progress (other than those already mentioned). 

e Any analyzer settings or registers (although clearing the output queue may 
indirectly affect the Status Byte’s MAV bit). 


The analyzer responds to both of the serial poll commands. The Serial Poll 
Enable (SPE) command causes the analyzer to enter the serial poll mode. 
While the analyzer is in this mode, it sends the contents of its Status Byte 
register to the controller when addressed to talk. 


When the Status Byte is returned in response to a serial poll, bit 6 acts as the 
Request Service (RQS) bit. If the bit is set, it will be cleared after the Status 
Byte is returned. 


The Serial Poll Disable (SPD) command causes the analyzer to leave the serial 
poll mode. 


If the analyzer is addressed to talk, this command causes it to take control 
of the HP-IB. It becomes the active controller on the bus. The analyzer 
automatically passes control back when it completes the operation that 
required it to take control. Control is passed back to the address specified by 
the *PCB command (which should be sent prior to passing control). 


If the analyzer does not require control when this command is received, it 
immediately passes control back. 


HP-IB Queues 
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Message Exchange 


The analyzer communicates with the controller and other devices on the 
HP-IB using program messages and response messages. Program messages are 
used to send commands, queries, and data to the analyzer. 


Response messages are used to return data from the analyzer. The syntax for 
both kinds of messages is discussed in Chapter 10. 


There are two important things to remember about the message exchanges 
between the analyzer and other devices on the bus: 


e The analyzer only talks after it receives a terminated query (see “Query 
Response Generation” later in this section). 


e Once it receives a terminated query, the analyzer expects to talk before it is 
told to do something else. 


Queues enhance the exchange of messages between the analyzer and other 
devices on the bus. The analyzer contains: 


e An input queue. 
e An error queue. 
e An output queue. 


Input Queue. 


The input queue temporarily stores the following until they are read by the 
analyzer’s coramand parser: 


» Device commands and queries. 
e The HP-IB END message (EO! asserted while the last data byte is on the 
bus). 


The input queue also makes it possible for a controller to send multiple 
program messages to the analyzer without regard to the amount of time 
required to parse and execute those messages. The queue holds up to 
128 bytes. It is cleared when: 


e The analyzer is turned on. 
e The Device Clear (DCL) or Selected Device Clear (SDC) command is 
received. 
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Command Parser 
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Error Queue. 


The error queue temporarily stores up to 20 error messages. Each time 
the analyzer detects an error, it places a message in the queue. When you 
send the SYST:ERR? query, one message is moved from the error queue to 
the output queue so it can be read by the controller. Error messages are 
delivered to the output queue in the order they were received. 


The error queue is cleared when: 


e All the error messages are read using the SYST: ERR? query. 
e The analyzer is turned on. 
e The *CLS command is received. 


Output Queue. 


The output queue temporarily stores a single response message until it is read 
by a controller. It is cleared when: 


e The message is read by a controller. 

e The analyzer is turned on. 

« The Device Clear (DCL) or Selected Device Clear (SDC) command is 
received. 


The command parser reads program messages from the input queue in the 
order they were received from the bus. It analyzes the messages to determine 
what actions the analyzer should take. 


One of the parser’s most important functions is to determine the position of a 
program message in the analyzer’s command tree (described in Chapter 10). 
When the command parser is reset, the next command it receives is expected 
to arise from the base of the analyzer’s command tree. 


The parser is reset when: 
e The analyzer is turned on. 


® The Device Clear (DCL) or Selected Device Clear (SDC) command is 
received. 


e A colon immediately follows a semicolon in a program message. (For more 
information see “Sending Multiple Commands” in Chapter 10.) 


e A program message terminator is received. A program message terminator 
can be an ASCII carriage return (“pn) or newline character or the HP-IB 
END message (EOI set true). 
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Query Response When the analyzer parses a query, the response to that query is placed in 

Generation the analyzer’s output queue. The response should be read immediately after 
the query is sent. This ensures that the response is not cleared before it is 
read. The response is cleared when one of the following message exchange 
conditions occurs: 


e Unterminated condition — the query is not properly terminated with an 
ASCH carriage return character or the HP-IB END message (EOI set true) 
before the response is read. 


e Interrupted condition — a second programm message is sent before the 
response to the first is read. 


e Buffer deadlock — a program message is sent that exceeds the length of the 
input queue or that generates more response data than fits in the output 
queue. 
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Synchronizing the Analyzer 
and a Controller 


The IEEE 488.2 standard provides tools that can be used to synchronize the 
analyzer and a controller. Proper use of these tools ensures that the analyzer 
is in a known state when you send a particular command or query. 


Device commands can be divided into two broad classes: 


« Sequential commands. 
e Overlapped commands. 


Most of the analyzer’s commands are processed sequentially. A sequential 
command holds off the processing of subsequent commands until it has been 
completely processed. 


Some commands do not hold off the processing of subsequent commands; 
they are called overlapped commands. 
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Overlapped Commands 


Typically, overlapped commands take longer to process than sequential 
commands. For example, the : INITIATE: IMMEDIATE command restarts a 
measurement. The command is not considered to have been completely 
processed until the measurement is complete. This can take a long time with 
a narrow or fine system bandwidth or when averaging is enabled. 


The analyzer has the following overlapped commands: 


ABORt 

CALibration: ZERO: AUTO 
CONFigure[i}2] 
DIAGnostic:CCONstants : LOAD 
DIAGnostic:CCONstants :STORe : DISK 
DIAGnostic:CCONstants :STORe : EEPRom 
DIAGnostic:DITHer 
DIAGnostic:SPUR: AVOid 
HcoPy [: IMMediate] 

INITiate [12] :CONTinuous 
INITiate [1/2] [:TMMediate] 
MMEMory : LOAD: STATe 

OUTPut[:STATe] 


PoWer [1 |2] :MODE 

PROGram[:SELected] :EXECute 

SENSe[1|2] :AVERage:CLEar 

SENSe[1|2] : AVERage :COUNt 

SENSe[1|2] :AVERage[:STATe] 

SENSe [1/2] :-BWIDth[:RESolution] 
SENSe[1|2] :CORRection:COLLect [:ACQuire] 
SENSe [1/2] :CORRection:COLLect :ISTate[: AUTO] 
SENSe [1/2] :CORRection:COLLect :METHod 
SENSe[1/2]:CORRection:COLLect :SAVE 
SENSe[1|2] :CORRection:CSET[:SELect] 
SENSe[1/2] :CORRection[:STATe] 
SENSe:COUPle 

SENSe [1/2] :DETector [:FUNCtion] 
SENSe[1|2] :DISTance: STARt (Option 100 only) 
SENSe[1|2] :DISTance: STOP (Option 100 only) 
SENSe[112] :FREQuency:CENTer 


2-3 


Synchronizing the Ai 
and 3 Controller 


nalyzer 


Overlapped Commands 


SENSe[1|2] : FREQuency :MODE (Option 100 only) 
SENSe[1]2] : FREQuency : SPAWN 

SENSe[112] :FREQuency : SPAN :MAXimum 
SENSe[1|2] :FREQuency:STARt 


SENSe[112]: 


FREQuency : STOP 


SENSe[1[2] : FUNCtion 


SENSe [1/2]: 


FUNCtion:SRL:SCAN[:IMMediate] (Option 100 only) 


SENSe: ROSCillator:SOURce 


SENSe[1[2] 
SENSe [112] 
SENSe [112] 


SENSe[1[2] 


:STATe 

:SWEep :POINts 
:SWEep : TIME 
:SWEep : TIME: AUTO 


SENSe : SWEep :TRIGger :SOURce 
soURce [1/2] :POWer[:LEVel] [: IMMediate] [:AMPLitude] 
SYSTem:PRESet 


TRACe[:DA1 


TA] 


TRIGger [: SEQuence] :SOURce 
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The NPO Flag 


The analyzer uses a No Pending Operation (NPO) flag to keep track of 
overlapped commands. The NPO flag is reset to 0 when an overlapped 
command has not completed (still pending). It is set to 1 when no overlapped 
commands are pending. The NPO flag cannot be read directly but all of the 
following common commands take some action based on the setting of the 
flag. 


*WAT Holds off the processing of subsequent commands until the NPO 
flag is set to 1. This ensures that commands in the analyzer’s input 
queue are processed in the order received. 


The program continues to run, and additional commands are 
received and parsed by the analyzer (but not executed), while 
waiting for the NPO flag to be set. Use of the *WAI command is 
explained later in this section and is demonstrated in the SETUP 
example program. 


*O0PC? Places a lin the analyzer’s output queue when the NPO flag is set 
to 1. If the program is designed to read the output queue before it 
continues, this effectively pauses the controller until all pending 
overlapped commands are completed. Use of the *0PC? command is 
explained later in this chapter and is demonstrated in the TRANCAL 
and REFLCAL example programs. 


*OPC Sets bit 0 of the Standard Event Status event register to 1 when the 
NPO flag is set to 1. The analyzer’s status registers can then be 
used to generate a service request when all pending overlapped 
cormmands are completed. This synchronizes the controller to the 
completion of an overlapped command, but also leaves the controller 
free to perform other tasks while the coramand is executing. 


NOTE 
*OPC only informs you when the NPO flag is set to 1. it does net hold off the processing of 


subsequent commands. No commands should be sent to the analyzer between sending the *OPC 
commend and receiving the service request. Any command sent will be executed end may affect how 
the instrument responds to the previously sent *OPC. 
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The *CLS and *RST commands cancel any preceding OPC command 

or query. Pending overlapped commands are still completed, but their 
completion is not reported in either the status register or the output queue. 
Two HP-IB bus management commands —- Device Clear (DCL) and Selected 
Device Clear (SDC) — also cancel any preceding *0PC command or query. 


NOTE 


Use *WAI, *OPC? or *OPC whenever overlapped commands are used. A recommended technique 
is to send *OPC? at the end of each group of commands. 


ALWAYS trigger an individual sweep (using *0PC? and waiting for the 

reply) before reading data over the bus or executing a marker function. The 
analyzer has the ability to process the commands it receives faster than it can 
make a measurement. If the measurement is not complete when the data is 
read or a marker search function is executed the results are invalid. 


The command to use (in an IBASIC OUTPUT statement) is: 


OUTPUT @Hp8711;"ABOR;:INIT:CONT OFF; :INIT;*0PC?" 
ENTER @Hp8711;Opc_done 


or another form of the :INITiate[1|2][:IMMediate] command combined 
with the *OPC? query. 


Refer to “Taking Sweeps” in Chapter 6 for more information. 
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Usage of *WAI and *OPC? 


The following example describes the use of the *WAI command. For this 
discussion, remember that a sequential command holds off the processing of 
subsequent commands until it has been completely processed. An overlapped 
cormmand does not. 


40 OUTPUT @Rfna;"command1" 

20 OUTPUT ORfna;"command2;*WAI" 
30 OUTPUT @Rina;"command3;" 

40 QUTPUT ORfna;"command4" 

50 END 


In the example above: 


e Commands 1 through 4 are sent to the analyzer as fast as the HP-IB bus 
traffic will allow, and the program may very well end before any command 
has been completed. 


e« Command 1 begins execution first. 


e The order in which commands 1 and 2 are completed depends on the 
command types. If both commands are overlapped commands (versus 
sequential commands), the order of completion is unknown. 


e Commands 3 and 4 will not be parsed until commands 1 and 2 are 
completed. 


e Command 3 will begin execution before command 4. 


e The order in which commands 3 and 4 are completed depends on the 
command types. If both commands are overlapped commands (versus 
sequential commands), the order of completion is unknown. 
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The following example describes the use of the *OPC? query and command. 
For this discussion, remember that a sequential command holds off the 
processing of subsequent commands until it has been completely processed. 
An overlapped command does not. 


10 OUTPUT @Rfna;"commandi” 

20 OUTPUT @Rfna;"command2;*0PC?" 
30 ENTER @Rfna; OPC 

40 OUTPUT @Rfna;'command3;" 

50 OUTPUT @Rfna;"command4;*0PC?" 
60 ENTER @Rina; OPC 

70 END 


In the example above: 


« Commands 1 and 2 are sent to the analyzer as fast as the HP-IB bus traffic 
will allow. 


e Command 1 will begin execution before command 2. 


e The order in which commands 1 and 2 are completed depends on the 
command types. If both coramands are overlapped commands (versus 
sequential cormmands), the order of completion is unknown. 


e When commands 1 and 2 are completed, commands 3 and 4 will be sent to 
the analyzer as fast as the HP-IB bus traffic will allow. 


e Command 3 will begin execution before command 4. 


« The order in which commands 3 and 4 are completed depends on the 
command types. If both commands are overlapped commands (versus 
sequential commands), the order of completion is unknown. 


e This program will not end until the OPC in line 60 is returned. 
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Passing Control 


When an external controller is connected to the analyzer with an HP-IB 
cable, passing control may be needed to control devices such as printers and 
plotters that are also connected on the HP-IB. For some operations the active 
controller must pass control to the analyzer. When the analyzer completes 
the operation, it autornatically passes control of the bus back to the external 
controller. 


An example program, PASSCTRL, demonstrates passing control to the 
analyzer. In this example program control is passed so the analyzer can 
control a printer for hardcopy output. See Chapter 8, “Example Programs.” 


NOTE 


Pass Control is not needed to contro! peripherals connected to the serial, parallel, or LAN ports. 


For smooth passing of control, take steps that ensure the following conditions 
are met: 


e The analyzer must know the controller’s address so it can pass control 
back. 


e The controller must be informed when the analyzer passes control back. 


Passing Control 


The following is a procedure for passing control: 


1. Send the controller’s HP-IB address to the analyzer with the *PCB 
command. 


2. Clear the analyzer’s status registers with the *CLS command. 


3. Enable the analyzer’s status registers to generate a service request when 
the Operation Complete bit is set. (Send *ESE with a value of 1 and *SRE 
with a value of 32.) 


4, Enable the controller to respond to the service request. 


5. Send the command that requires control of the bus followed by the *0PC 
command. 


6. Pass control to the analyzer and wait for the service request. The service 
request indicates that the command has been completed and control has 
been passed back to the controller. 


NOTE 


For this procedure te work properly only the command that requires control of the bus should be 
pending. Other overlapped commands should not. For more information on overlapped commands, see 
Chapter 2, “Synchronizing the Analyzer and a Controller.” 
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Data Types and Encoding 


Data is transferred between the analyzer and a controller via the HP-IB data 
lines, DIO] through DIO8. Such transfers occur in a byte-serial (one byte 

at a time), bit-parallel (8 bits at a time) manner. This section discusses the 
following aspects of data transfer: 


e The different data types used during data transfers. 
» Data encoding used during transfers of numeric block data. 


Data Types 


The analyzer uses a number of different data types during data transfers. 
Data transfer occurs in response to a query. The data type used is determined 
by the parameter being queried. The different parameter types are described 
in the “Parameter Types” section of Chapter 10. Data types described in this 
section are: 


Numeric Data. 
Character Data 
String Data 
Expression Data 
Block Data 


Numeric Data 


The analyzer returns three types of numeric data in response to queries: 


NR1 data Integers (such as +1, O, -1, 123, -12345). This is the 
response type for boolean parameters as weil as some 
numeric parameters. 


NR2 data Floating point numbers with an explicit decimal point (such 
as 12.3, +1.234, -0.12345). 
NR3 data Floating pot numbers in scientific notation (such as 


+4.23E+5, +123.4E-3, -456.789E+6). 
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Character Data 


Character data consists of ASCH characters grouped together in mnemonics 
that represent specific instrument settings (such as MAXimum , MINimum 

or MLOGarithmic). The analyzer always returns the short form of the 
mnemonic in upper-case alpha characters. 


String Data 


String data consists of ASCII characters. The string must be enclosed by a 
delimiter, either single quotes (7 This is string data.’) or double quotes 
(‘This is also string data."'). To include the delimiter as a character in 
the string it must be typed twice without any characters in between. The 
analyzer always uses double quotes when it returns string data. 


Expression Data 


Expression data consists of mathematical expressions that use character 
parameters. When expression data is sent to the analyzer it is always 
enclosed in parentheses (such as CIMPL/CH1SMEM) or CIMPL)). The analyzer 
returns expression data enclosed in double quotes. 
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Block Data 


Block data are typically used to transfer large quantities of related data (like a 
data trace). Blocks can be sent as definite length blocks or indefinite length 
blocks — the instrument will accept either form. The analyzer always returns 
definite length block data in response to queries. 


The general form for a definite block length transfer is: 
#<num_digits><num_bytes><data_bytes> 


In the definite length block, two numbers must be specified. The single 
decimal digit <num_digits> specifies how many digits are contained in 
<num_bytes>. The decimal number <num_bytes> specifies how many data 
bytes will follow in <data_bytes>. An example IBASIC (or HP BASIC) 
statement to send ABC+KYZ as a definite block length parameter is shown, 
note that the data block contains seven bytes (7} and only one digit is needed 
to describe the block length 1. 


OUTPUT 716; "#17ABC+XYZ" 


NOTE 


This analyzer will send an additional <> with EOI asserted for definite block length transfers. The 
definite length block form for your analyzer is: 


#<num_digits><num_bytes><data_bytes><°p><E0I> 


<num_bytes> is the number of <data_bytes> without counting <°p><E0I>. 


Indefinite Block Length 


Data Types and Encoding 
Data Types 


The general form for an indefinite block length transfer is: 


#0<data_bytes><p><EOI> 


After the last data byte is sent, the indefinite length block must be terminated 
by sending a carriage return or newline with EO! asserted. This forces the 
termination of the program message. An example IBASIC (or HP BASIC) 
statement to send ABC+XYZ as an indefinite block length parameter is shown, 
note that ,END is used to properly terminate the message. 


OUTPUT 716; "#OABC+XYZ" ,END 
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The FORMat :DATA command selects the type of data and the type of data 
encoding that is used to transfer large blocks of numeric data between the 
analyzer and a controller. There are two specifiers: 


REAL specifies the block data type. Either the definite or indefinite 
length syntax can be used. The block is transferred as 
a series of binary-encoded floating-point numbers. Data 
transfers of the REAL, 64 data type are demonstrated in the 
REALDATA example program. 


INTeger specifies the block data type. Either the definite or indefinite 
length syntax can be used. The block is transferred as an 
array of binary-encoded data with each point represented 
by a set of three 16-bit integers. This is the instrument’s 
internal format — it should only be used for data that will be 
returned to the instrument for later use. Data transfers of 
the INTeger, 16 data type are demonstrated in the INTDATA 
and LOADCALS example programs. 


ASCLi specifies the numeric data type (NR1, NR2 or NR3 syntax). 
The data is transferred as a series of ASCII-encoded numbers 
separated by commas. ASCii formatted data transfers are 
demonstrated in the ASCDATA example program. 


Blocks that contain mixed data -- both numbers and ASCII characters — 
ignore the setting of FORMat :DATA. These blocks always transfer as either 
definite length or indefinite length block data. The following commands 
transfer blocks of mixed data: 


PROGram[:SELected] :DEFine 
SYSTem:SET 
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ASCTI Encoding 


The ANSI X3.4-1977 standard defines the ASCII 7-bit code. When an 
ASCII-encoded byte is sent over the HP-IB, bits 0 through 6 of the byte 
(bit 0 being the least significant bit) correspond to the HP-IB data lines DIO} 
through DIO7. D108 is ignored. 
When ASCE encoding is used for large blocks of data, the number of 
significant digits to be returned for each nuraber in the block can be specified. 
For example, the following command returns all numbers as NR3 data with 7 
significant digits. 

FORMat:DATA ASCii,7 


Binary Encoding 


When binary encoding is used for large blocks of data, all numbers in the 
plock are transferred as 32-bit or 64-bit binary floating point numbers or as 
an array of 16-bit integers. The binary floating-point formats are defined in 
the ISEE 754-1985 standard. 

FORMat :DATA REAL ,32 selects the IFEE 32-bit format (not sup- 

ported by IBASIC or HP BASIC). 
FORMat :DATA REAL ,64 selects the IEEE 64-bit format. 
FORMat :DATA INTeger,16 selects the 16-bit integer format. 
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Byte Swapping 


PC compatibles frequently use a modification of the IEEE floating point 
formats with the byte order reversed. To reverse the byte order for data 
transfer into a PC, the FORMat :BORDer command should be used. 


FORMat:BORDer SWAPped selects the byte-swapped format 
FORMat:BORDer NORMal selects the standard format 
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Using Status Registers 


The analyzer’s status registers contain information about the condition of the 
network analyzer and its measurements. This section describes the registers 
and their use in HP-IB programming. 


Example programs using the status registers are included in Chapter 8, 
“Example Programs.” These prograrns include SRQ and GRAPHICS which 
use service request interrupt routines, PASSCTRL which uses the status byte 
to request control of the HP-IB and LIMITEST which uses the Limit Fall 
condition register. 
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The analyzer’s status system is based on the general status register model 
shown in Figure 5-1. Most of the analyzer’s register sets include all of the 
registers shown in the model, although commands are not always available 
for reading or writing a particular register. The information flow within a 
register set starts at the condition register and ends at the register summary 
bit (see Figure 5-2). This flow is controlled by setting bits in the transition 
and enable registers. 


Two register sets the Status Byte and the Standard Event Status 
Register — are 8-bits wide. All others are 16-bits wide, but the most 
significant bit (bit 15) in the larger registers is always set to 0. 


Condition Register ( STATus:emnemonic>:CONDition? ) 
~~~ Positive Transition Fikter ( STATus:<mnemonic>:P TRansition } 
| Negative Transition Fitter ( STATus:<mnemonic>:NTRansition } 
| ~~ Event Register ( STATus:<mnemonic> LEVEN? } 


| a Enable Register { STATus-<mnemonicoENABIe ) 
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Figure 5-1. General Status Register Madel 


Using Status Registers 
General Status Register Model 


Condition Register 


Condition registers continuously monitor the instrument’s hardware and 
firmware status. Bits in a condition register are not latched or buffered, they 
are updated in real time. When the condition monitored by a specific bit 
becomes true, the bit is set to 1. When the condition becomes false the bit is 
reset to 0. Condition registers are read-only. 


Transition Registers 


Transition registers control what type of change in a condition register will 
set the corresponding bit in the event register. Positive state transitions 

(Oto 1) are only reported to the event register if the corresponding positive 
transition bit is set to 1. Negative state transitions (1 to 0) are only reported 
if the corresponding negative transition bit is set to 1. Setting both transition 
bits to 1 causes both positive and negative changes to be reported. Transition 
registers are read-write, and are unaffected by *CLS (clear status) or queries. 
They are reset to instrument default conditions at power up and after *RST 
and SYSTem:PRESet commands. 


Event Register 


Event registers latch any reported condition changes. When a transition bit 
allows a condition change to be reported, the corresponding event bit is set 
to 1. Once set, an event, bit is no longer affected by condition changes. It 

remains set until the event register is cleared. Event registers are read-only. 


An event register is cleared when you read it. All event registers are cleared 
when you send the *CLS (clear status) command. 
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Enable Register 


Enable registers control the reporting of events (latched conditions) to the 
register summary bit. If an enable bit is set to 1 the corresponding event 

is included in the logical ORing process that determines the state of the 
summary bit. (The summary bit is only set to 1 if one or more enabled event 
bits are set to 1.) Summary bits are recorded in the instrument’s status byte. 
Enable registers are read-write and are cleared by *CLS (clear status). 


Positive 


Transition 
Register 


[| Enable 


Register 


em 
yee peo Mt To 
\ or i | AND } >» Summary 
ben o| | / Bit 
Condition Event 
Register Register 
AND 
i i 
nS Note: 
i 
tgs The Evert Register remains set unt it is read 
Negative or the CLS command is seni. 
Transition 


Register 
Figure 5-2. Flow of information within a register set 


A) 
nH 


How to Use Registers 


There are two methods of accessing the information in status registers: 
e The direct-read method. 
« The service request (SRQ) method. 


In the direct-read method the analyzer is passive. It only tells the controller 
that conditions have changed when the controller asks the right question. In 
the SRQ method, the analyzer is more active. It tells the controller when 
there has been a condition change without the controller asking. Either 
method allows you to monitor one or more conditions. 


The following steps are used to monitor a condition with the direct read 
method: 


1. Determine which register contains the bit that monitors the condition. 
2. Send the unique HP-IB query that reads that register. 
3. Examine the bit to see if the condition has changed. 


The direct-read method works well when it is not necessary to know 

about changes the moment they occur. It does not work well if immediate 
knowledge of the condition change is needed. A program that used this 
method to detect a change in a condition would need to continuously read the 
registers at very short intervals. The SRQ method is beiter suited for that 
type of need. 
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The Service Request Process 


The following steps are used to monitor a condition with the SRQ method: 
1. Determine which bit monitors the condition. 


2. Determine how that bit reports to the request service (RQS) bit of the 
Status Byte. 


3. Send HP-IB commands to enable the bit that monitors the condition and to 
enable the summary bits that report the condition to the RQS bit. 


4, Enable the controller to respond to service requests. 


When the condition changes, the analyzer sets its RQS bit and the HP-IB’s 
SRQ line. The controller is informed of the change as soon as it occurs. The 
time the controller would otherwise have used to monitor the condition can 
now be used to perform other tasks. The controller’s response to the SRQ is 
determined by the program. being run. 
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Generating a Service Request 


A service request is generated using the Status Byte. As shown in Figure 5-3, 
the analyzer’s other register sets report to the Status Byte. Some of them 
report directly while others report indirectly through other register sets. 
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Figure 5-3. Generating a Service Request 
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The process of preparing the analyzer to generate a service request, and the 
handling of that interrupt when it is received by a program, are demonstrated 
in the SRQ example program. 


When a register set causes its summary bit in the Status Byte to change from 
0 to 1, the analyzer can initiate the service request (SRQ) process. If both the 
following conditions are true the process is initiated: 


e The corresponding bit of the Service Request enable register is 
also set to 1. 


e The analyzer does not have a service request pending. (A service request is 
considered to be pending between the time the analyzer’s SRQ process is 
initiated and the time the controller reads the Status Byte register with a 
serial poll.) 


The SRQ process sets the HP-IB’s SRQ line true and sets the Status Byte’s 
request service (RQS) bit to 1. Both actions are necessary to inform the 
controller that the analyzer requires service. Setting the SRQ line informs 
the controller that some device on the bus requires service. Setting the ROS 
bit allows the controller to deterrnine that the analyzer was the device that 
initiated the request. 


When a program enables a controller to detect and respond to service 
requests, it should instruct the controller to perform a serial poll when the 
HP-IB’s SRQ line is set true. Each device on the bus returns the contents of 
its Status Byte register in response to this poll. The device whose RQS bit is 
set. to 1 is the device that requested service. 


NOTE 


When the analyzer’s Status Byte is read with a serial poll, the ROS bit is reset to 0. Other bits in the 
register are not affected. 


AS implied in Figure 5-3, bit 6 of the Status Byte register serves two 
functions; the request service function (RQS) and the master summary status 
function (MSS). Two different methods for reading the register allow you to 
access the two functions. Reading the register with a serial poll allows you to 
access the bit’s RQS function. Reading the register with *STB allows you to 
access the bit’s MSS function. 


The Analyzer’s Status Register Sets 


The analyzer uses eight register sets to keep track of instrument status: 


Status Byte *STB? and *SRE 
Device Status STATus :DEVice 
Limit Fail STATus :QUEStionable:LIMit 


Questionable Status STATus :QUEStionable 
Standard Event Status *ESR? and *ESE 


Measuring Status STATus :OPERation:MEASuring 
Averaging Status STATus :OPERation:AVERaging 
Operational Status STATus :OPERation 


Their reporting structure is surnmarized in Figure 5-4. They are described in 
greater detail in the following section. 


NOTE 


Register bits not explicitly presented in the following sections are not used by the analyzer. A query to 
one of these bits returns a value of 0. 
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Figure 5-4. Analyzer Register Sets 
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Status Byte 


The Status Byte register set summarizes the states of the other register sets 
and monitors the analyzer’s output queue. It is also responsible for generating 


service requests (see “Generating a Service Request” earlier in this chapter). 
See Figure 5-5. 


serial pot bit 6 = Request Service) 
os ¥STB? (bit 6 = Master Summary Status) 


C ¥SRE 
(e) 
4 
Device Status Summary [E & 
Questionable Status Summary [E 2 
Message Available 8 oeepae Se 
Standard Event Summary 5 Ej | 
Request Service/Master Summery Status [Rcs[tssp % = | 
Operational Status Summary Cae PY 


—o 


Figure 5-5, The Status Byte Register Set 


The Status Byte register set does not conform to the general status register 
model described at the beginning of this chapter. It contains only two 
registers: the Status Byte register and the Service Request enable register. 
The Status Byte register behaves like a condition register for all bits except 
bit 6. The Service Request enable register behaves like a standard enable 
register except that bit 6 is always set to 0. 
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Bits in the Status Byte register are set to | under the following conditions: 


Device Status Summary 


Questionable Status Summary 


Message Available 


Standard Event Status 


Summary 


Master Summary Status 


Request Service 


Operational Status Summary 


(vit 2) is set to 1 when one or more enabled 
bits in the Device Status event register are 
set to 1. 


(bit 8) is set to 1 when one or more enabled 
bits in the Questionable Status event register 
are set to 1. 


(bit 4) is set to 1 when the output queue 
contains a response message. 


(bit 5) is set to 1 when one or more enabled 
bits in the Standard Event Status event 
register are set to 1. 


(bit 6, when read by ¥*STB) is set to 1 when 
one or more enabled bits in the Status Byte 
register are set to 1. 


(bit 6, when read by serial poll) is set 

to 1 by the service request process (see 
“Generating a Service Request” earlier in 
this chapter). 


(bit 7) is set to 1 when one or more enabled 
bits in the Operational Status event register 
are set to 1. 
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The commands used to read and write the Status Byte registers are listed 
below: 


SPOLL an IBASIC (or HP BASIC) cormmand used in the service 
request process to determine which device on the bus is 
requesting service. 


*STB? reads the value of the instrument’s status byte. This is a 
non-destructive read, the Status Byte is cleared by the *CLS 
coramand. 


*SRE <num> sets bits in the Service Request Enable register. The current 
setting of the Service Request Enable register is stored in 
non-volatile memory. If *PSC has been set, it will be saved 
at power on. 


*SRE? reads the current state of the Service Request Enable 
register. 
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Device Status Register Set 


The Device Status register set monitors the state of device-specific 
parameters. 


Bits in the Device Status condition register are set to 1 under the following 
conditions: 


Key Pressed (bit 0) is set to 1 when one of the analyzer’s front panel 
keys has been pressed. 


Any Softkey (bit. 1) is set to 1 when one of the analyzer’s softkeys has 
Pressed been pressed. 


Any External (bit 2) is set to 1 when a key has been pressed on an 
Keyboard Key external keyboard connected to the DIN KEYBOARD 
Pressed. connector on the rear panel of the analyzer. 


Front Panel (bit 3) is set to 1 when the analyzer’s front panel knob is 
Knob Turned = turned. 


al 
or 
on 
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Limit Fail Register Set 


The Limit Fail register set monitors limit test results for both measurement 
channels. 


Bits in the Limit Fail condition register are set to 1 under the folowing 
conditions (refer also to Figure 5-6.) 


Measurement (bit 0) is set to 1 when limit testing is enabled and any point 
Channel 1 on measurement channel 1 fails the limit test, or when any 
Limit Failed enabled marker limit on measurement channel 1 has failed. 


Measurement (Dit, 1) is set to 1 when limit testing is enabled and any point 
Channel 2 on measurement channel 2 fails the limit test, or when any 
Limit Failed enabled marker limit on measurement channel! 2 has failed. 


Measurement (bit 2) is set to 1 when any enabled marker limit on 
Channel 1 measurement channel 1 has failed. 

Marker Limit 

Failed 

Measurement (bit 3) is set to 1 when any enabled marker limit on 
Channel 2 measurement channel 2 has failed. 

Marker Limit 

Failed 


N | 
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Figure LIMPAIL here. 


Figure 5-6. The Limit Fail Register Set 


Insert 9x17 drawing cd61¢ 
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Questionable Status Register Set 


The Questionable Status register set monitors conditions that affect the 
quality of measurement data. 


Bits in the Questionable Status condition register are set to 1 under the 
following conditions: 


Limit. Fail (bit 9) is set to 1 when one or more enabled bits in the Limit 
Fail event register are set to lL. 


Data (bit 10) is set to 1 when a change in the analyzer's 
Questionable configuration requires that new measurement data be taken. 
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Standard Event Status Register Set 


The Standard Event Status register set monitors HP-IB errors and 
synchronization conditions. See Figure 5-7. 


Operation Complete 
Request Control 

Query Error 

Device Dependent Errar 
Execution Error 
Command Error 

User Request 

Power On 


Logical OF 


: cee BRS 
: Status Byte 
: 


Feber 


Figure 5-7. The Standard Event Status Register Set 


The Standard Event Status register set does not conform to the general status 
register model described at the beginning of this section. It contains only two 
registers: the Standard Event Status event register and the Standard Event 
Status enable register. The Standard Event Status event register is similar 
to other event registers, but behaves like a register set that has a positive 
transition register with all bits set to 1. The Standard Event Status enable 
register is the same as other enable registers. 
Operation (bit 0) is set to one when the following two events occur 
Complete (im the order listed): 

e The *0PC command is sent to the analyzer. 


e The analyzer completes all pending overlapped 
commands. 
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(bit 1) is set to 1 when both of the following conditions 
are true: 


« The analyzer is configured as a talker/istener for HP-IB 
operation. 

« The analyzer is instructed to do something (such as 
plotting or printing) that requires it to take control of 
the bus. 


(bit 2) is set when the command parser detects a query 
error. A query error indicates: . 


1. an attempt to read data from the Output Queue when 
no data was present. 


2. that data in the Output Queue was lost. An example 
of this would be queue overflow. 


(bit 8) is set to 1 when the command parser detects a 
device-dependent error. A device-dependent error is any 
analyzer operation that did not execute properly due 

to some internal condition such as overrange. This bit 
indicates that the error was not a command, query, or an 
execution error. 


(bit 4) is set to 1 when the cornmand parser detects an 
execution error. Execution errors occur when: 


1. a <PROGRAM DATA> element received in a cormmand 
was outside the legal range for the analyzer, or 
inconsistent with the operation of the analyzer. 


the analyzer could not execute a valid command due 
to some analyzer condition. 


(bit 5) is set to 1 when the command parser detects a 
coramand error. The following events cause a command 
error: 


J. An IEEE 488.2 syntax error. This means that the 
analyzer received a message that did not follow the 
syntax defined by the 488.2 standard. 


2. A semantic error occurred. For example, the analyzer 
received an incorrectly spelled command. Another 
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example would be that the analyzer received an 
optional 488.2 command that it does not implement. 


Power On (bit 7) is set to 1 when you turn on the analyzer. 


The commands used to read and write the Standard Event Status registers are 
listed below: 


*ESR? reads the value of the standard event status register. 


*ESE <num> sets bits in the standard event status enable register. The 
current setting of the standard event statue enable register 
is stored in non-volatile memory. If *PSC has been set, it 
will be saved at power on. 


+ESE? reads the current state of the standard event status enable 
register. 
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Measuring Status Register Set 


The Measuring Status register set monitors conditions in the analyzer’s 
measurement process. 


Bits in the Measuring Status condition register are set to 1 under the 
following conditions: 


Channel 1 Measuring (bit 0) is set to 1 while the analyzer is collecting 
measurement data on channel 1. 


Channel 2 Measuring (bit 1) is set to 1 while the analyzer is collecting 
measurement data on channel 2. 


Averaging Status Register Set 


The Averaging Status register set monitors conditions in the analyzer’s 
measurement process when the trace averaging function is in use. 


Bits in the Averaging Status condition register are set to 1 under the following 
conditions: 


Measurement Channel (bit 0) is set to 1 while the analyzer is sweeping on 

1 Averaging measurement channel 1 and the number of sweeps 
completed (since “average restart”) is less than the 
averaging factor. 


Measurement Channel (bit 1) is set to 1 while the analyzer is sweeping on 

2 Averaging measurement channel 2 and the number of sweeps 
completed (since “average restart”) is less than the 
averaging factor. 
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Operational Status Register Set 


The Operation Status register set monitors conditions in the analyzer’s 
measurement process, disk operations, and printing/plotting operations. It 
also monitors the state of the current HP Instrument BASIC program. 


Bits in the Operational Status condition register are set to 1 under the 
following conditions: 


Calibrating (bit 0) is set to 1 while the instrument is zeroing the 
broadband diode detectors. 

Settling (bit 1) is set to 1 while the measurement hardware is 
settling. 

Measuring (bit 4) is set to 1 when one or more enabied bits in the 
Measuring Status event register are set to 1. 

Correcting (bit 7) is set to 1 while the analyzer is performing a 
calibration function. 

Averaging (bit 8) is set to 1 when one or more enabled bits in the 
Averaging Status event register are set to 1. 

Hardcopy (bit 9) is set to 1 while the analyzer is performing a 

Running hardcopy (print or plot) function. 

Test Running (bit 10) is set to 1 when one of the analyzers internal 
service tests is being run. 

Program Running (bit. 14) is set to 1 while an HP Instrument BASIC 


program is running on the analyzer’s internal controller. 
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STATus:PRESet Settings 


Executing the STATus:PRESet command changes the settings in the enable 


(ENAB), positive transition (PTR} and negative transition (NTR) registers. The 
table below shows the settings after the command is executed. 
Register Set 7 EVABle PTRansition | WTRansition 
STATus :DEVice all Os all 1s all Os 
STATus : QUEStionable:LIMit all 1s all 4s all Os 
STATus : QUEStionable all Os all 1s all Os 
STATus : OPERation: MEASuring all is all Os all 1s 
STATus : OPERation: AVERaging all is all Os ali 1s 
STATus : OPERation all Os all ds all Os 
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Analyzer Register Set Summary 
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Trace Data Transfers 


This chapter explains how to read (query) the measurement data trace from 
the analyzer into your program. It also describes how to send data from your 
program to the analyzer’s measurement arrays. Accessing the measurement 
arrays is done using SCPI commands. If you are using IBASIC (Option 102), 
you can also access the measurement arrays using high-speed subroutines. 
Refer to the HP Instrument BASIC User’s Handbook for more details. 


Figure 6-1 is a data processing flow diagram that represents the flow of 
numerical data. The data passes through several math operations, denoted in 
the figure by single-line boxes. Most of these operations can be selected and 
controlled with the front panel CONFIGURE block menus. The data is stored 
in arrays along the way, denoted by double-line boxes. These arrays are 
places in the flow path where data is accessible via HP-IB. While only a 
single flow path is shown, two identical paths are available, corresponding to 
measurement channels 1 and 2. 


1 
ti Le): 2 SEROr ; Correctes 
Ratio = “| correction [TM] Averosing tele i 
Coefficient | Corrected | 
Arras | Memory i 
Lem _—— | 


Trace 
Math 


Ls 


Electrical 7 « PM) Formatted PP Offset pm Date Trove 
H | Transform Format | 
Deloy P|] Arroys ,  Sccie te Memory Trace 


inal! 
Lieeerererenee 
ls Markers: 
.e Limit. Testing 


Figure 6-1. Numeric Data Flow Through the Network Analyzer 
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Querying the Measurement Trace Using BASIC 


After making a measurement, you can read the resultant measurement trace 
out of the analyzer using the SCP! query 


"TRACE:DATA? CHIFDATA" 


The BASIC program segment below shows how to read the trace from the 
analyzer into an array in your program. 


10 REAL Trace(1:201) 

20 ASSIGN @Hp8711 TO 716 

30 ! Take sweep here 

40 OUTPUT @Hp8711;"FORM:DATA ASCII,5” 

50 OUTPUT @Hp8711;"TRACE:DATA? CHIFDATA" 

60 ENTER @Hp8711;Trace(*) 

70 DISP Trace(1),Trace(2),Trace(3),". 2..." 


In this program, the TRACE: DATA? query returns all of the measurement 
points as a single block. The analyzer computes the value for each point 
using the measurement format selected by the [FORMAT] menu (CALC:FORM 
SCPI command), and returns a block of data called the formatted data array. 
The values of each point correspond to the values displayed on the screen, or 
those shown in the marker readouts. The frequency stimulus value (X-axis) of 
each point is not returned by the TRACE: DATA? query; only the measurement 
response (Y-axis) values are returned. 


When transferring the block of trace data, you may select either binary or 
ASCII data encoding. This is explained in Chapter 4 in the section titled 
“Data Encoding for Large Data Transfers.” Notice that the terms “encoding 
format” and ‘measurement format” are not the same. The encoding 

format determines how the numbers are represented as bytes, while the 
measurement format corresponds to the meaning of the value of the numbers. 


The easiest way to transfer a measurement data trace is to use ASCII data 
encoding. 


In the example above, the array Trace(1:201) contains 201 real (floating point) 
numbers. The SCPI command "FORM:DATA ASCII,5" specifies ASCH data 
encoding, with 5 significant digits. The command "TRACE:DATA? CHIFDATA" 
instructs the analyzer to send the measurement trace. The ENTER statement 
reads the measurement data sent by the analyzer into the Trace(1:201) array. 


6-3 


10 
20 
30 
40 
50 
60 
70 


Trace Date Transfers 
Querying the Measurement Trace Using BASIC 


It is important to make sure that the Trace array declared in your program 

is the same size as the measurement trace on the analyzer, or an error will 
occur, The ENTER statement attempts to read data from the analyzer until 

it completely fills the Trace array, at which point it expects to receive a 
end-of-data terminator from the analyzer. To be safe, your program should 
use the "SENS:SWE:PQIN" SCPI coramand to set the number of measurement 
data points to the desired value. 


Refer to the example program ASCDATA in Chapter 8 for a complete 
example. 


eSmith Chart and Polar Formats 


Each measurement point is represented by a single floating point number. 
This is the case for all of the analyzer’s measurement formats except Smith 
Chart and Polar in the HP 8712C and 8714C. When Smith Chart or Polar 
format is selected, each point is represented by two numbers, the first one 
being the real portion and the second being the imaginary portion of the 
complex measurement value. 


Below is a modified example program that will work when using Smith Chart 
or Polar formats. 


REAL Trace(1:201,1:2) 

ASSIGN @Hp8711 TO 716 

! Take sweep here 

OUTPUT @Hp8711;"FORM:DATA ASCII ,5" 

QUTPUT OHp8711;"TRACE:DATA? CHIFDATA" 

ENTER @Hp8711;Trace(*) 

DISP Trace(1,1),Trace(1,2),". . . .",Trace(201,1),Trace(201,2) 


6-4 © indicates HP 8712C/14C only 


Querying the Measurement Trace Using SICL 


This section includes a complete SICL C program that shows how to read the 
measurement trace from the analyzer. 


Je SOOO SOO GOH GO nS ECE IORI GU ICEGIG RGR IEICE I ICI 
* This program takes a sweep, reads the trace, and prints it. 

* It uses SICL (Standard Instrument Control Library) to talk 

* to the analyzer over HP-IB. 

* 

* Qn HP-UX, compile using: cc -Aa -o query.trace query_trace.c -lsicl 
Fe SEG SSO I IOC O ASO Iara OES CACO ISIS IEICE OR ISIE ok ski a ik a3 / 


#include <sicl.h> /* For iopen(), iprintf(), iscanf(), INST, ... */ 
#include <stdio.h> /* For printf) */ 
int main(void) 
{ 
INST analyzer; /* Handle used to talk to analyzer */ 
float data buf[i601]; /* measurement trace. 32-bit floats */ 
int num_trace, bytes; 
int pt; 


num_trace_bytes = sizeof(data_buf); /* Set to max allowable bytes */ 


/* Open the network analyzer at address 16 */ | 
analyzer = iopen("hpib,16"); / 


/* Clear the bus */ 
iclear(analyzer) ; 


/* Abort current sweep and put analyzer sweep in hold */ 
iprintf(analyzer, "ABORT\n"); 
iprintf(analyzer, "INIT:CONT OFF\n"); 


/* Take one sweep, wait until done */ 
iprintf(analyzer, "INITI\n"); 
iprintf (analyzer, "*0PC?7\n"); 
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iscanf(analyzer, "4*s"); 


/* Request the trace data in 32-bit floating point format */ 
iprintf (analyzer, “FORM:BORD NORM\n"); 
iprintf (analyzer, "FORN:DATA REAL,32\n"); 


/* Query the trace, read into data_buf[]. */ 
iprintf (analyzer, "TRAC? CHIFDATA\n"); 
iscanf(analyzer, "%tbixc", &num_trace.bytes, &data_buf [0]; 


/* Print the trace values. */ 
for (pt = 0; pt < num_trace,bytes/sizeof(float); pt++) f{ 
: printf ("44d Yge\n", pt, data buf [pt]); 


/* Close analyzer and exit. */ 
{close (analyzer); 
return 0; 


Using Binary Data Encoding 


The previous section describes how to query the measurement trace, and 
transfer it into your program using ASCII encoding. Binary encoding can be 
used for faster data transfers, as shown in the table below: 


Table 6-1. Typical Trace Transfer Times {ms} 


an 

Number of Points Binary | ASCIL| 
st a far | 
201 a | 164 
401 30 | 314 
1601 82 | 1200 


When using binary data transfers, the entire trace is sent from the analyzer 
to your program in a block called a definite length block. The details of block 
data are described in detail in Chapter 4. The definite length block contains a 
header and a data section. The header indicates how many bytes are in the 
data section. 


In order to read the definite length block, your program must first read 
the header, and then read the data section. Refer to the example program 
REALDATA in Chapter 8 for an example of how to do this. 


In the REALDATA program, you will notice the following lines which read the 
definite block header: 


180 ENTER @Hp8711 USING "%,A,D";4$,Digits 
190 ENTER @Hp8711 USING "4, "2VAL$(Digits)&"D" ; Bytes 


and these lines which read the data section: 


200 ASSIGN GHp8711;FORMAT OFF 
210 ENTER @Hp8711;Datai(*) 
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Each measurement point in the data section is represented as 4 or 8 bytes 
(82 or 64 bits), depending on whether single precision or double precision 
numbers are requested. When using HP BASIC or IBASIC, you must select 
double precision numbers to match BASIC’s “REAL” data type. Do this 
using the SCPI command "FORM: DATA REAL, 64". If you are using another 
language that supports single precision data types, you can select single 
precision using the SCPI command "FORM: DATA REAL,32". Languages such 
as QuickBASIC and C have support for both single and double precision 
floating point numbers. 


When transferring data using binary encoding, you may need to reverse 
the order of the bytes in each measurement point, since PCs frequently 
store IEEE floating point numbers with the byte order reversed. To instruct 
the analyzer to reverse the byte order of the data, send the command 
“FORMAT :BORDer SWAPped" before querying the trace data. 
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Trace Data Transfer Sizes 


The following table shows how many bytes are transmitted during trace 
data transfers. The left column shows the format of the data, which you can 
specify using the SCPI command Format :DATA. As you can see, the size of 
the measurement point data and trace data varies as you change format. 


Tabie 6-2. Size of Trace Data Transfers (in Bytes) Using the TRACE:DATA SCP! Command 


Format Type Type af Data Single Measurement Point 201 Point Trace 
(FORMat :DATA) — 
Real Complex Real Complex 

REAL,32 (EEE 32-bit 4 8 803 1614 
Floating Point 

REAL,64 IEEE 64-bit 8 16 1814 3222 
Fieating Point 

ASCIHL,S ASCH numbers 18 26 2613 5206 

ASCH,S ASCH numbers "1 22 2211 4422 

INT.16 Internal Binary 6 - 1212 


When transmitting data in “REAL” or “INT” format, a header is sent before 
the data block. The header indicates the size of the data block. The header 
size varies in length from 3 to 11 bytes. Refer to Chapter 4 for details on the 
header. 


Transmitting ASCII data requires no header. The ASCII values are separated 
by commas, and a linefeed is sent after the last value. The sizes shown in the 
table include the size of the comma(s) and terminating linefeed. Typical data 
in ASCH,5 format: 


-1.2254E+000 ,+5 .0035E-001 ,+4.5226E~001,... 


The analyzer stores its internal data with approximately 5 significant digits 
of resolution. Using REAL,32 or ASCI,5 format provides sufficient precision 
for data transfers. However, REAL,64 may be necessary when using a 
programming language which does not support IERE 32-bit floating point. 
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Transferring Data with IBASIC 


If you are using IBASIC, your IBASIC program can avoid the overhead of 
using OUTPUT and ENTER to transfer trace data, and instead use the 
analyzer’s built-in high-speed subprograms. These built-in subroutines let 
you quickly move data between the analyzer’s measurement arrays and your 
program’s data arrays. For example, to read the analyzer’s formatted data 
array, use the following: 


10 DIM Fmt(1:201) 

20 INTEGER Chan 

30 LOADSUB Read_fdata FROM "XFER:MEM 0,0" 
40 Chan=1 

50 Read_fdata(Chan, Fmt (*)) 


Refer to the HP Instrument BASIC User’s Handbook for more details. 


The table below compares the speed of IBASIC using high-speed transfer 
subroutines with that of a fast externa! controller using the SCPI 
TRACE: DATA? CHiFDATA query. 


Table 6-3. Typical Trace Transfer Times (ms} 


Number of Points | Controller Using Binary TRACE : DATA? | IBASIC Using Read_fdata 
$1 24 7 
201 23 18 
401 30 8 
1801 82 32 
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Taking Sweeps 


When making measurements and querying traces, your program should 
perform the following steps: 


1. Place the analyzer’s sweep in hold 

2, Initiate a single sweep 

3. Wait for the sweep to complete 

4, Query the measurement trace 

Use the following program lines perform these steps: 


10 OUTPUT @Hp87i1;"ABORT; :INIT1:CONT OFF" 
20 OUTPUT GHp8711;"INIT1" 

30 OUTPUT @Hp8711;"*0PC?" 

35 ENTER @Hp8711;Opc 

40 OUTPUT GHp8711;"TRACE:DATA? CH1IFDATA" 
45 ENTER @Hp8711;Fmt(*) 


If you query the measurement trace while the analyzer is in continuous 
sweep, the query will still work, but the data may not be correct. Using INIT 
and *OPC? ensures that a complete sweep has finished before you query the 
measurement data. In many cases, you can also use the command “*WAI’ in 
place of the “*OPC?” query, replacing lines 30 and 35 above with: 


30 OUTPUT @Hp8711;"*WAI" 


However, there are cases where "*WAI" will produce incorrect results. One 
case is when using IBASIC’s high-speed subprograms to query the trace data. 
"*HAT" only ensures that the SCPI cormmands following the "*WAI" are not 
executed until the commands before the "*WAI" are complete. Since IBASIC 
subprograms don’t use SCPI commands to access the trace data, "*WAI" is 
ineffective, and "*0PC?" should be used. : 


When using "*0PC?", the ENTER statement following the "*0PC?" will wait 
until the previous SCPI commands are complete, preventing your program 
from executing beyond the ENTER statement. When using "*WALI", your 
program can continue to run and send SCPI commands, and the analyzer will 
buffer them and act wpon them in order. 


For more details, refer to Chapter 2, “Synchronizing the Analyzer and a 
Controller.” 
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CALC:DATA? versus TRACE:DATA? 


The SCPI command "CALC1:DATA?" is functionally equivalent to the 
command "TRACE:DATA? CH1FDATA". The two can be used interchangeably 
for trace queries of the formatted measurernent data. The "TRACE: DATA" 
command is more flexible, allowing you to query other measurement arrays 
and to download data to measurement arrays. 
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Querying Single Data Points Using Markers 


If you only need to query a single data point, you can use a marker query 
instead of a trace query. The program segment below shows how to do this 
using the SCPI command CALC:MARK. 


10 
20 
30 
40 
50 
60 
70 


ASSIGN @Hp8711 TO 716 
! Take sweep here 


OUTPUT @Hp8711;"CALC1:MARK ON" ! turn on marker 
OUTPUT GHp8711;"CALC1:MARK1:X 177 MHz" ! set frequency 
OUTPUT @Hp8711;"CALC1:MNARK1:Y?" ! read marker 


ENTER @Hp8711;Marker_y 
DISP Marker_y 


You can also use the CALC: MARK :FUNC:RES? query to return the results of a 
bandwidth search. For example: 


10 
20 
30 
40 
50 


! Select -3 dB bandwidth 

OUTPUT @Hp8711;"CALC:MARK:BWID -3" 

! Get result of bandwidth search 

OUTPUT @Hp8711;"CALC:MARK:FUNC:RES?" 
ENTER @Hp8711;Bwidth,Center_freq,Q,Loss 


For more information on using markers, refer to Chapter 8, “Example 
Programs. ” 
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Accessing Other Measurement Arrays 


The preceding sections describe how to query the formatted data array using 
the TRACE:DATA? query with the argument CHIFDATA. The formatted array 
is the last array in the analyzer’s data processing chain, and is generally of 
most interest. 


The analyzer also allows you to query other measurement arrays which 
are earlier in its data processing chain. Figure 6-2, below, shows the data 
processing chain. 
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Figure 6-2, Numeric Data Flow Through the Network Analyzer 


The first array is the Raw Data Array, which contains each of the separate 
input components (A, B, R, B*, R*, X, ¥, AUX) immediately after they are 

measured. These arrays can be queried and set, but doing so is of limited 

use, since the data values contained in the arrays are uncorrected, and are 
not directly correlated to any meaningful reference, such as 0 dBm. 


6-14 


Trace Data Transfers 
Accessing Other Measurement Arrays 


The Error Coefficient Arrays contain default correction values or values 
created during a measurement calibration. These arrays can be queried 

and set, but care should be exercised in setting them since incorrect 
measurements may result. If you wish to apply your own corrections in 
addition to the analyzer’s current correction, the best technique is to use the 
Corrected Memory array and the Data/Memory feature, explained below. 


The Corrected Data array contains the results of the currently selected 
measurement (Transmission, Reflection, etc.) after error correction and 
averaging have been applied. The measurement data in these arrays is 
represented as complex number pairs. When measuring the transmission 
response of a through cable, the magnitude of the complex numbers will be 
very close to 1.0. When measuring an open circuit, the magnitude of the 
complex numbers will be very close to 0.0. When measuring an amplifier, the 
magnitude of the complex numbers will be greater than 1.0. 


The Corrected Memory array is filled with a copy of the Corrected Data array 
when the Data —> Memory operation is performed. It can be used to apply 
a gain correction to the measured data. This is described in the following 
section. 


The Formatted Data array contains the measurement data after it has been 
formatted using the format selected by the [FORMAT] menu. Querying the 
Formatted Data array is described in detail at the beginning of this chapter. 
You can also download data to this array, and the analyzer will display the 
data using the current Scale and Reference values. 


Applying Gain Correction Using the 
Memory Trace 


The Corrected Memory array is filled with a copy of the Corrected Data array 
when the Data —> Memory operation is performed. By setting the analyzer 
to perform Data/Memory trace math, you can apply your own correction 
factor to the measurement data trace by filling the Corrected Memory array 
with the appropriate complex numbers. 


In general, you should use the analyzer’s calibration feature to correct for 
errors in your system. However, there may be cases where you wish to 
simulate the effect of adding a cable in series with your DUT, and observe 
how this imaginary cable will attenuate the measured response versus 
frequency. Or you may wish to apply an absolute offset to simulate the effect 
of adding or removing a pad from the measurement. These simulations are 
easily accomplished using the Corrected Memory array and the Data/Memory 
feature. 


The Corrected Data and Memory arrays contain complex linear data, as 
opposed to logged data. When displaying the traces using Lin Mag format, 
the result of the Data divided by Memory operation (Data/Mem) will be 

to divide each point of the data trace by each point of the memory trace. 
When displaying data in Log Mag format, the result of Data/Memory will be 
equivalent to subtracting the Log Mag value of the Memory trace from that of 
the Data trace. 
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Trace Date Transfers 
Applying Gain Correction Using the 
Memory Trace 


The following example BASIC code segment shows how to download a 
complex array from your program to the analyzer’s Memory trace. The 
program's “Mem” array is initialized with the proper values such that when 
the analyzer computes Data divided by Memory, the desired increasing gain 
will be applied. 


100 REAL Mem(1:201,1:2) 
110 ASSIGN @Hp8711 TO 716 
120 ! Fill memory array (denominator in Data/Mem) 
130 ! with values that will result in an 
140 { upward sloping gain factor vs. frequency. 
17 
' 


150 Used to compensate for cable loss vs. frequency 
160 ! Adds 0 dB of gain at start freq; 3 dB at stop freq 
170 FOR Pt=1 TO 201 

180 Gain_factor_db=3.0*(Pt — 1}/200 1! 0..3 dB Power 
190 Gain_factor_lin=107 (Gain. factor_db/20) 

200 Mem(Pt,1)=1.0/Gain_factor_lin ! real 

210 Mem(Pt ,2)=0.0 ! imag 

220 NEXT Pt 

230 ! Download to the memory trace 

240 OUTPUT @Hp8711;"FORM:DATA ASCIT" 

250 OUTPUT @Hp8711;"TRACE:DATA CHISMEM" ; ! Note the ";" 
260 FOR Pt=i TO 201 

270 FOR [=i TO 2 

280 OUTPUT @Hp8711;",";Mem(Pt,I) ; 1 Note the ';" 
290 NEXT I 

300 NEXT Pt 

310 OUTPUT @Hp8711;"" ! Send linefeed 

320 OUTPUT @Hp8711;"CALC1:MATH CIMPL/CHISMEM)" ! Data/Mem 


The example above downloads data to the corrected memory array. The data 
is sent by the program to the analyzer using ASCI encoding. The data is 
sent as ASCII characters, separated by commas. The analyzer accepts the 
comma separated list of numbers until it receives a linefeed to terminate 

the command. The program uses semicolons at the end of some OUTPUT 
statements to avoid sending a linefeed until all of the data has been sent. 
After the last number is sent, the program sends a linefeed, and the analyzer 
accepts the data. 


Remember, for faster transfers, use binary data encoding instead of ASCI. 
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Performing Your Own Data Processing 


After the analyzer has made a measurement, you can read the measurement 
trace and perform your own post-processing on it, and display the result on 
the screen. This is done using these steps: 


1. Initiate a sweep 

2. Wait for the sweep to finish 

3. Read the measurement data into an array in your program 

4, Perform your post-processing on the measurement data 

5. Write (download) the post-processed data to the analyzer’s memory trace. 


You may want to instruct the analyzer to display only the mernory trace and 
not the data trace, so that only your post-processed data is seen. 
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Trace Data Transfers 
Performing Your Gwn Data Processing 


The program below demonstrates how to perform data post-processing. It 
takes the measurement data and reverses it, such that the low frequency 
data is displayed on the right end of the trace, and the high frequency data is 
displayed on the left. 


100 ! Display the measurement data backwards 

110 REAL Fmt(1:201) 

120 ASSIGN @Hp8711 TO 716 

130! 

140 OUTPUT @Hp8711;"FORM:DATA ASCII" 

150 OUTPUT @Hp8711;"ABOR;INIT:CONT OFF; *WAI" 

160 OUTPUT @Hp8711;"DISP:WIND:TRACi OFF ;TRAC2 ON" 


170 LOOP 

180 ! Take sweep : 
190 OUTPUT @Hp8711;"INIT1;*WAL" i 
200 ! Read the trace from the formatted data array | 
210 OUTPUT @Hp8711;"TRACE:DATA? CHIFDATA" 
220 ENTER @Hp8711;Fmt (*) 

230 ! Download the trace, backwards, 

235 ! to the formatted memory array 

240 OUTPUT @Hp8711;"TRACE:DATA CH1FMEM"; ! Note the "3" 
250 FOR Pt=1 TO 201 

260 OUTPUT @Hp8711;",";Fmt(202-Pt) ; ! Note the ";" 
270 NEXT Pt 

280 QUTPUT @Hp8711;"" ! Send linefeed 


290 END LOOP 


This example program uses ASCII trace data transfers. Higher speed can be 
achieved using binary data transfers. If using IBASIC, high-speed subroutines 
can be used for even greater performance. Refer to the IBASIC Handbook for 
details. 
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Downloading Trace Data Using 
Binary Encoding 


Data traces can be downloaded to the analyzer using binary encoding. 
Using binary encoding is faster than using ASCII encoding. As mentioned 
in Chapter 4, the binary encoded trace is transferred as a block; the block 
containing a header and a data section. There are two different types of 
blocks that can be used: a definite length block, and an indefinite length 
block. 


To send trace data using a definite length block, your program must calculate 
the number of bytes in the data segment of the block, and create a block 
header which tells the analyzer how many bytes are in the data segment. 


For example, if you are sending a trace with 201 data points and using 64-bit 
floating point numbers for each data point (“FORM:DATA REAL,64”), the 
block’s data segment will contain 1608 bytes (201 points * 8 bytes/point). 
The header characters for a 1608 byte block are: “#41608°. The first digit 
after the ‘#”, “4” tells how many following digits are used to specify the size. 
In this case, 4 digits follow, and those digits are “1608”, meaning that the 
block contains 1608 bytes. 


For example: 
TRAC CHIFDATA,#41608<binary_data_starts_here> 


When you send a definite length block to the analyzer, the analyzer will will 
read the data segment bytes, stopping when it receives the number specified 
in the block header. 


To send trace data using an indefinite length block, your program simply 
sends a block header of “#0”, followed by the data segment. After sending 
the data segment, your program must terminate the data block by sending an 
EOI. The analyzer will read the data segment bytes, stopping when it receives 
an EOI. To send an EO! using BASIC, you can use the statement: 


OUTPUT CHp&8711;END 
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Internal Measurement Arrays 


The following sections describe the sequence of math operations and the 
resulting data arrays as the measurement information flows from the raw 
data arrays to the display. This information explains the measurement arrays 
accessible via HP-IB. 


Figure 6-3 is a data processing flow diagram that represents the flow of 
numerical data. The data passes through several math operations, denoted in 
the figure by single-line boxes. Most of these operations can be selected and 
controlied with the front panel CONFIGURE block menus. The data is stored 
in arrays along the way, denoted by double-line boxes. These arrays are 
places in the flow path where data is accessible via HP-IB. While only a 
single flow path is shown, two identical paths are available, corresponding to 
measurement channels I and 2. 
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Figure 6-3. Numeric Data Flow Through the Network Analyzer 
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Trace Data Transfers 
Internal Measurement Arrays 


Raw Data Arrays 


These arrays are linear measurements of the inputs used in the selected 
measurement. Note that these numbers are complex pairs. These arrays are 


directly accessible via HP-I 


and CH[LI2] RFWD. 


Table 6-4. Raw Data Arrays 


IB and referenced as CH[1] 2] AFWD, CHL1|2] BFWD 


Selected Measurement Raw Arrays 
‘Transmission (B/R} 8 = CH[1]2]BFWD, Rh - CH[112] RFwD 
Refiaction (A/R} A = CHLILQ]AFWD, R - CH[1/ 2] RF UD 
A A = CH[112] AFWD 
B 8 = CHL1/ 2] BFWD 
R 2 = CH[1|2]RFWwD 
Power {B*] B* = CH[1/2] BF WD 
Conversion Loss (8*/R*! 8 = CH[112]BFWD, R* - CHL1/2]RFWD 
Re R* = CHLL[2] RFWD 
AM Delay {Y/Xi Y = CHL1|/2]BFWD, X = CH[1| 2] RFWD 
Xx X= CHL1/2]RFWD 
Y Y = CHL1}2] 8FWD 
yiR* Y » CHL1/2] BFW, R* - CHL1]2]RFuD 
YK, AY. Y= CHL1[2]BFwp, X = CH[1] 2] RFWD 


= 


NOTE 


Raw data for AUX INPUT is not available vie HP-IB. Use the corrected data array to access AUX 
INPUT data. 
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Trace Data Transfers 
Internal Measurement Arrays 


Ratio Calculations 


These are performed if the selected measurement is a ratio (e.g. A/R or B/R). 
This is simply a complex divide operation. If the selected measurement is 
absolute (e.g. A or B), no operation is performed. 


Error Correction 


Error correction is performed next if correction is turned on. Error correction 
removes repeatable systematic errors (stored in the error coefficient arrays) 
from the raw arrays. The operations performed depend on the selected 
measurement type. 


Error Coefficient Arrays 


The error coefficient arrays are either default values or are created during 
a measurement calibration. These are used whenever correction is on. 
They contain complex number pairs, and are accessible via HP-IB and are 
referenced as CH[1|2]SCORR1, CH[1|2]SCORR2, CH[1!2]SCORR3 and 
CH[1/2]ScORR4. 
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Trace Data Transfers 
Internal Measurement Arrays 


Table 6-5. Error Coefficient Arrays 


Selected Measurement 


Error Coefficient Arrays 


Transmission (B/R} Response 


cai 


2]SCORR1 = Tracking 


Transmission {B/R] Response & 'solation 


cat 
cHfi 


2ISCORR1 = Tracking 
2ISCORR2 ~ Isolation Term 


‘Transmission {B/R) Enhanced Response 


cH 
cHt1 
cH 
cali 


DISCORR1 ~ Directivity 
2]SCORR2 = Source Match 
2QISCORRS = Reflection Tracking 
2ISCORR4 = Transmission Tracking 


Reflection [A/R} 


CHE 
cHEi 


2ISCORR1 = Directivity 
2]SCORR2 = Source Match 
2]SCORR3 = Tracking 


Broadband Internal 


|CHL1 
T 
cH[1 


2ISCORR1 = R* Response 


NOTE 


These arrays do not apply to Broadband External measurements. 
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Trace Data Transfers 
Internal Measurement Arrays 


Averaging 


Averaging is a noise reduction technique. This calculation involves taking 
the complex exponential average of several consecutive sweeps. This 
averaging calculation is different than the System Bandwidth setting. System 
Bandwidth uses digital filtering, applying noise reduction to the measured 
data before it is stored mto the Raw Data Arrays. 


Corrected Data Arrays 


The combined results of the ratio, error correction and averaging operations 
are stored in the corrected data arrays as complex number pairs. These 
arrays are accessible via HP-IB and referenced as CH[1|2]SDATA. 


Corrected Memory Arrays 


If the Data->Mem or Normalize operations are performed, the corrected 
data arrays are copied into the corrected memory arrays. These arrays are 
accessible via HP-IB and referenced as CH[1|2]SMEM. 


Trece Data Transfers 
Internal Measurement Arrays 


Trace Math Operation 


This selects either the corrected data array, or the corrected memory array, or 
both to continue flowing through the data processing path. In addition, the 
complex ratio of the two (Data/Memory) can also be selected. If memory is 
displayed, the data from the memory arrays goes through exactly the same 
data processing flow path as the data from the data arrays. 


& Electrical Delay 


This block adds or subtracts phase, based on the settings of Phase Offset, 
Electrical Delay, and Port Extension. The Electrical Delay and Port Extension 
features add or subtract phase in proportion to frequency. This is equivalent 
to “line stretching” or artificially moving the measurement reference plane. 
(See the HP 8712C/I4C User’s Guide for more details on these features.) 


Transform (Option 100 only) 


This block converts frequency domain data into distance domain, or into an 

SRL impedance value when measuring fault location or SRL. The transform 

employs an inverse fast Fourier transform (FFT) algorithm to accomplish the 
conversion. 
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Trace Data Transfers 


Formatting 


This converts the complex number pairs into a scalar representation for 
display, according to the selected format (e.g. Log Mag, SWR, etc). These 
formats are often easier to interpret than the complex number representation. 
Note that after formatting, it is impossible to recover the complex data. 


Formatted Arrays 


The results so far are stored in the formatted data and formatted memory 
arrays. It is important to note that marker values and marker functions are 
all derived from the formatted arrays. Limit testing is also performed on the 
formatted arrays. These arrays are accessible via HP-IB and referenced as 
CH[112] FDATA and CH[112] FMEM. 


Offset and Scale 


These operations prepare the formatted arrays for display. This is where the 
reference position, reference value, and scale calculations are performed, as 
appropriate for the format. 
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Treoe Data Transfers 


Using Graphics 


Using Graphics 


The analyzer has a set of user graphics commands that can be used to create 
graphics and messages on the display. The GRAPHICS example program uses 
some of these commands to draw a simple setup diagram. These commands, 
listed below, are of the form: 


DISPLay :WINDow [112110] :GRAPhics:<mnemonic>. 


The number specified in the WINDow part of the command selects where the 
graphics are to be written, 


WINDow1 draws the graphics to the channel 1 measurement screen. 
(This is the default if no window is specified in the 
mnemonic.) 

WINDow2 draws the graphics to the channel 2 measurement screen, 

WINDowiO draws the graphics to an IBASIC display partition. (This 


window is only available on instruments with IBASIC — 
Option 102.) 


NOTE 
When graphics commands are used to write directly to a Measurement screen they write to the static 


graphies plane (the same plane where the graticule 8 drawn. There is no sweep-to-sweep speed 
penalty once the graphics have been drawn. 
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Using Graphics 


Unless otherwise specified, the graphics commands listed below start at the 
current pen location. All sizes are dimensioned in pixels. 


DISPlay:WINDow[1|2[10] :GRAPhics:CIRCle <y_radius> 
DISPlay: WINDow [1/2/10] :GRAPhics:CLEar 
DISPlay : WINDow [1|2].10] :GRAPhics:COLor <pen> 


e color choices are: 0 for erase, 1 for bright, 2 for dim 
DISPlay:WINDow[112{10] :GRAPhics[:DRAW] <new_x>,<new_y> 


DISP. 


ay: WINDow[112110] :GRAPhics:LABel <string> 


DISPlay:WINDow [112110] :GRAPhics:LABel : FONT <font> 


e fon 


choices are: SMAL1, HSMall, NORMal, HNGRmal, BOLD, HBOLd, 


SLANt, HSLant 
(H as the first letter of the font name indicates highlighted text - inverse 
video). 


DISP 


ay: WINDow[1{2]10] :GRAPhics:MOVE <new_x>, <new_y> 


DISPlay:WINDow[1|2]10] :GRaPhics:RECTangle <width>,<height> 


DISPlay:WINDow[1|2]10] :GRAPhics :SCALe 
<xmin> ,<xmax>,<ymin> ,<ymax> 


DISPlay:WINDow[112[10] :GRAPhics :STATe? 
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Window Geometry 


Even though there are only three graphics windows, these windows can have 
different sizes and locations. 


The size and location of the graphics window are determined by the display 
configuration currently in use — split screen measurements, full screen 
measurements, and full or partial IBASIC display partitions will affect the 
dimensions of the graphics window in use. 


The sizes of the different graphics windows are listed below. Figure 7-1 


shows the IBASIC display partitions. 


Measurement channel 1 or 2 full screen measurement: width=501 pixels, 
height=401 pixels. 


Measurement channel 1 or 2 split screen measurement: width=501 pixels, 
height =201 pixels. 


IBASIC full screen display: width=537 pixels, height = 439 pixels. 
TBASIC upper display: width=537 pixels, height = 199 pixels. 
IBASIC lower display: width=537 pixels, height= 197 pixels. 


OH39} (837,438) | (0,199} {587,189) 

‘ i f2ASiC UPPER display partion 

} i 
} | | 
Los} 637.0) 
TASS FULL dlplay parton 

(797) (537.197) 

TBASIC LOWER dispioy partition 
0.9} (837.0) | ro) 637.0) 


beste 


Figure 7-1. Pixel Dimensions with Available Display Partitions 


There is a set of queries that can be used to determine the size and location 
of the display window in use. 
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Using Graphics 
Window Geometry 


These queries. listed below, return the width and height of the window or the 
absolute location of its lower left or upper right corners. All the coordinates 
and sizes are dimensioned in pixels. 


DISPlay : WINDow[1|2]10] :GEOMetry :LLEFt? 
DISPlay : WINDow[1]2]10] :GEOMetry :SIZE? 
DISPlay : WINDow[1{2]10] :GEOMetry :URIGht? 


NOTE 
The origin of EVERY graphics window is its lower left corner. The locations returned in response to 


the LLEFt and URIGht are relative to the ABSOLUTE origin of the entire display, NOT to the 
graphics window. 


The Graphics Buffer 


The analyzer has a graphics buffer that is used to refresh the graphics display 
if needed. When the buffer is full, additional graphics can still be drawn — 
BUT they will not be refreshed. The graphics buffer can be turned on and 
off using the following command (which is used in the GRAPHICS example 
program). 
DISPlay:WINDow:GRAPhics:BUFFer[:STATe] <ON|OFF> 

The graphics buffer will hold up to: 

500 lines 

40 circles 


40 rectangles 
50 strings (60 characters long) 


Use the following command to clear the graphics buffer and user-graphics 
display. 


DISPlay:WINDow:GRAPhics:CLEar 


NOTE 


Only graphics that can be refreshed will be printed or plotted. if you intend to print or plot your 
graphics, make sure they will fit within the graphics buffer. 
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Example Programs 


Example Programs 


Most of the example programs listed in this manual are written in HP BASIC. 
They are also compatible with IBASIC (HP Instrument BASIC). An optional 
internal controller can be purchased with your analyzer (Option 102). This 
controller runs IBASIC directly on the analyzer. It controls the analyzer over 
an internal interface bus that operates the same way as the external HP-IB 
interface. For more information about IBASIC refer to the HP Instrumeni 
BASIC User’s Handbook. : 


The example programs are provided on two disks that are included with the 
network analyzer. Both disks contain the same examples which are written 
mainly in HP BASIC, only the disk format is different. The analyzer’s internal 
3.5” disk drive is designed to be DOS compatible, however, it can read from 
LIF formatted disks. Therefore, either disk can be used to supply programs 
for the analyzer’s internal IBASIC controller. 


Example Programs Disk — DOS Format HP part number 08712-10019 
Example Programs Disk - LIF Format HP part number 08712-10021 


Because the exarnples are designed to run in different environments, the 
setup at the beginning of each program must determine the operating 
environment and properly set the analyzer’s HP-IB address. In these 
examples, the internal IBASIC controller uses the address 800 when 
communicating with the analyzer (the internal HP-IB is at select code 8). 
The default address of 716 is used when the programs are being run on an 
external controller. 


A version of the following lines is included in most of the example programs. 
The use of the Internal (internal-controller) flag varies due to differences in 
the programs needs. 


10 
20 
30 
40 


50 
60 
70 


80 


90 


IF POS(SYSTEM$ ("SYSTEM ID") ,"HP 87") THEN 
ASSIGN @Hp8711 TO 800 
Internal=1 

ELSE 


ASSIGN @Hp8711 TO 716 
Internal=0 
ABORT 7 


CLEAR 716 


END IF 


NOTE 
The example programs on the disks that were shipped with your analyzer may net appear exactly as 


Example Pregrams 


Identify the operating system. 
If internal, set address to 800. 
Set internal-control flag to I. 

If external, set address to 716. 


Set internal-control flag to 0. 
Abort all bus transactions and 
give active control of the bus to the 
computer. 

Send a selected device clear (SDC) 
to the analyzer — this clears all 
HP-IB errors, resets the HP-IB in- 
terface and clears syntax errors. 
(it does not affect the status re- 
porting system.) 


listed in this chapter. The programs on the disks are the most up-to-date versions of each program. 
Also, check your disk listings for new programs that may not be listed here. 
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Example Programs 


The following table shows the sections and example programs that are 


contained in this chapter: 
Section Title Example Pregram Pregram Description 

Configuring Measurements SETUP Sets up a basic measurement, demonstrates use of *WAT 
LIMITEST Performs automatic pass/fail testing with limit lines 
POWERSWP Performs a power sweep measurement 

Transfer of Data to/from the MARKERS Vansters data using markers 

Analyzer 
SMITHMKR? Measures reflection of a filter in Smith chart and polar formats 
ASCDATA Transiers data using ASCII format 
REALDATA Transfers data using the IEEE 84-bit floating point REAL format 

TDATA Transiers data using the 16-bit INTEGER format 

FAST_CW Trensfers marker data in CW sweep mode 

Calibration RANCA\ Performs a transmission calibration 
REFLCAL | Performs @ reflection calibration 
LOADCALS Uploads and downloads correction arrays 
CALKIT This is not a program, it is an instrument state file for downloading 

user-defined cal kit definitions 

Instrument State and Save/Recall | LEARNSTR Uses the learn string to upload and download instrument states 
SAVERC! Saves and recalls instrument states, calibrations and date 

Hardcopy Control PRINTPL Uses the serial and parallel ports for hardcopy output 
PASSCTRL Uses pass contre! and the HP-IB for hardcopy output 
FAST..PRT Provides fast graph dumps to PCLS printers 

Service Request SRO Generates 2 service request Interrupt 

| SRO_INT Monitors the status report of the analyzer 

File Transfer Over HP-IB GETALE Transfers a file from the analyzer to an external controlier 

| PUTFILE Transfers a file from an external controller to the analyzer 


‘L For use with HP 8712C and 87140 enly 


Example Programs 


Seetion Title Example Program Program Description 
Customized Display GRAPHICS Uses graphics and softkeys to create customized procedures 
GRAPH2 Draws an instrument end DUT onto the display 
GETPLOT Demonstrates how to read an HPGL graphics file 
Annotation USERANOT Demonstrates how to use user-defined annotation 
FREGBLNK | Demonstrates how to conceal sensitive frequency information 
KEYCODES Reads key presses and knob positions from the analyzer 
Marker Functions MKR.. MATH Demonstrates how to program marker math functions istatistics, 
flatness, and RF filter stats} 
Marker Limit Testing UM_FLAT Demonstrates how io test for a marker flatness limit 
LIM_PEAK. Demonstrates haw to test for a marker peak-to-peak ripple limit 
| UM_MEAN Demonstrates how to test for a marker mean limit 
— 
SRL Measurements? MEAS_SRL Demonstrates the effects of various connector madeling on a 
structural return loss {SRL} measurement 
SRL_SRG Initiates an SRL cable scan, then uses the analyzer’s status model to 
trigger an SRO when the cable scan has completed 
fault Location Measurements FAULT Demonstrates the effects of various fault location frequency modes on] 
a cable measurement 
USR..FLOC Shows how fault location measurements can be simplified by using 
the User BEGIN. key? 


1 Option 100 only 


2 You must have Option 1€2, IBASIC, installed te use the “User BEGIN” function 


Example Programs 


Section Title Example Program Program Description 

Multiport Test Set Measurements? | PORT_SEL Uses graphics to show internal connections of the HP 87075C when 

different ports are selected 
TSET_CAL Attempts to recall “TSET_CALCAL” from non-volatile RAM or the 

internal disk drive. If successful, invokes the recalled test set cal for 
transmission and reflection of measurement channels | and 2 

TTL Output TTLIG Monitors the user TTL bit sn rear panel 

AM Delay? | aoe Demonstrates the calibration and AM delay measurement of a 
bandpass filter 

LAN Usage? See the Option 1/7 User's Guide for listings and information on example programs for LAN 


[usage 


1 For use with the HP 87075C multiport test set. 


2 Options 1DA or 108 only 
3 Gption 1F7 only 


Configuring Measurements 


SETUP 


LIMITEST 


POWERSWP 


Setting up a basic measurement. The exaraple also 
demonstrates the use of the *WAI command. 


Performing automatic PASS/FAIL testing with limit lines. 
The example also demonstrates some methods of combining 
mnemonics for more efficient programming. 


Setting up a power sweep measurement. 
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1010 
1020 
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1040 
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1130 ! 


1140 
1150 
1160 
1170 
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1220 !} 
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1240 
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1280 ! 
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Example Programs 
Canfiguring Measurements 


SETUP Example Program 


This program demonstrates how to set up the analyzer to make a basic 
measurement. The *WAI command is used extensively throughout this 
program. This has the effect of making sure that the commands are executed 
in the order they are received. More information about making measurements 
with the analyzer is available in your analyzer’s User’s Guide. 


'Filename: SETUP 


t 
! Description: 

! Set Channel 1 to measure filter’s transmission. 

! Set Channel 2 to measure filter’s reflection 

! Prompt user for start and stop freq, and set them. 
Take a sweep. 

: Set Scale and Reference levels. 

t 

I 


COM /Sys_state/ @Hp87xx ,Scode 
! Identify I/O Port 

CALL Iden_port 

1 


! Preset the instrument. 
QUTPUT GHp87xx;"SYST:PRES; *WAI" 
+ 


! Configure the analyzer to measure transmission 
! of a filter on channel i. This is the command 
! for the BEGIN Filter Transmissn key sequence. 
OUTPUT @Hp87xx;"CONF ’FILT: TRAN’ ;*WAL" 

1 


! Put the instrument in trigger hold mode. 
OUTPUT OHp87xx;"ABOR;:INIT:CONT OFF;*WAI" 
t 


! Turn on channel 2. 
OUTPUT @Hp87xx;"SENS2:STAT ON;*WAI" 
1 


! Configure channel 2 to measure reflection. This 
! is the command for the CHAN 2 Reflection key sequence. 
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OUTPUT @Hp87xx;"SENS2:FUNC ’?XFR:POW:RAT 1,0°;DET NBAN" 
1 

! Wait for the previous commands to complete execution 
! (respond to the *0PC?). 

OUTPUT @Hp87xx;"*OPC?" 

ENTER @Hp87xx ;Ope 

' 


! Input a start frequency. 

INPUT "Enter Start Frequency (MHz):",Start_f 

i 

! Input a stop frequency. 

INPUT "Enter Stop Frequency (MHz):",Stop_f 

{ 

! Set the start and stop frequencies of the analyzer 
! to the values entered. 


! Trigger a single sweep. 
QUTPUT @Hp87xx; "INIT; *OPC?" 
1 


! Wait for the sweep to be completed. 
ENTER @Hp87xx;Ope 
1 ’ 


! Set up the scale and reference parameters for channel 1. 
OUTPUT @Hp87xx;"DISP:WIND1:TRAC:Y:PDIV 10 DB;RLEV O DB;RPOS 8” 
1 


! Now for channel 2. 

QUTPUT @Hp87xx;"DISP:WIND2:TRAC:Y:PDIV 5 DB;RLEV O DB;RPOS 8" 
t 

! Make channel 1 active (transmission) 

OUTPUT @Hp87xx;"SENS1:STAT ON" 

t 

! Display the current start and stop frequencies. 


QUIPUT @Hp87xx;"SENS2:FREQ:STAR" ;Start_f;"MHz;STOP" ;Stop_£; "MHz; *WAI" 
1470 ! 


DISP "Done measuring. Start =";Start_f; "MHz Stop =";Stop_f; "MHz" 


END 
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Perrrerrrrrrtrrtrrrrtrrerrrer nero cf. fs toss 2a tk ooo e 2 te ees sod 
! Iden_port: Identify io port to use. 
! Description: This routines sets up the 1/0 port address for 
! the SCPI interface. For "HP 87xx" instruments, 
! the address assigned to @Hp87xx = 800 otherwise, 
i 716. 
Dicobe Rng aS dori iii icici ia 2a aaa EGGERS ICI AOR a ACA I A IC ek 
SUB Iden_port 
COM /Sys_state/ @Hp87xx,Scode 
t 
IF POS(SYSTEM$("SYSTEM ID"), "HP 87")<>0 THEN 
ASSIGN @Hp87xx TO 800 
Scode=8 
ELSE 
ASSIGN GHp87xx TO 716 
Scode=7 
END IF 
a 


SUBEND !Iden_port 
t 
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Configuring Measurements 


LIMITEST Example Program 


This program demonstrates how to set up and use limit lines over the HP-B. 
The example device used in this program is the demonstration filter that is 
shipped with the analyzer. The program sets up the basic measurement, 
downloads the limit lines and uses the status registers to determine of the 
device passes its specifications. For more information about limit lines, refer 
to the User’s Guide. For information about using the status registers, refer to 
the previous section “Using the Status Registers.” 


This example also demonstrates how multiple command mnemonics can be 
combined together. The easiest commands to corabine are ones that are 
closely related on the command tree (such as the start and stop frequency 
of a limit segment). For more information of command mnemonics, refer to 
Chapter 10, “Introduction to SCPI.” 


'Filename: LIMITEST 

: 

DIM Title$[30] 

1 

1 

COM /Sys_state/ @Hp87xx,Scode 

! Identify 1/0 Port 

CALL Iden_port 

U 

! Perform a system preset; this clears the limit table. 
OUTPUT @Hp87xx;"SYST:PRES ;#WAT" 

i 

! Set up the source frequencies for the measurement. 
OUTPUT @Hp87xx;"SENS1:FREQ:STAR 10 MHZ;STOP 400 MHZ;*WAI" 
] 

! Set up the receiver for the measurement parameters 

! (Transmission in this case). 

OUTPUT @Hp87xx;"SENS1:FUNC ’XFR:POW:RAT 2,0°;DET NBAN;*WAI" 
' 

! Configure the display so measurement 

! results are easy to see. 


OUTPUT @Hp87xx;"DISP:WIND1:TRAC:Y:PDIV 10 DB;RLEV 0 DB;RPOS 9" 
i 
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! Reduce the distractions on the display by 
! getting rid of notation that will not be 
! needed in this example. 

OUTPUT @Hp87xx;"DISP:ANN:YAX OFF" 

4 


! Erase the graticule grid for the same reason. 
OUTPUT @Hp87xx;"DISP:WIND1:TRAC:GRAT:GRID OFF" 
1 


! Create and turn on the first segment for 

! the new limit lines; this one is a maximum 

! Limit. 

OUTPUT @Hp87xx;"CALC1:LIM:SEGM1 :TYPE LNAK;STAT ON" 
i 


! Set the amplitude limits for the first limit 

! segment. 

QUTPUT @Hp87 xx; "CALC1:LIM:SEGM1 : AMPL:STAR -70;STOP -70" 
t 


! Set the frequency of the first limit segment. 
QUTPUT @Hp87xx;"CALC1:LIM:SEGM1:FREQ:STAR 10 MHZ;STOP 75 MHZ" 
i 


! Create and turn on a second maximum Limit 

! segment. 

OUTPUT GHp87xx;"CALC1:LIM:SEGM2:TYPE LMAX;STAT ON" 
1 


! Set the amplitude limits for segment 2. 
OUTPUT @Hp87xx;"CALCi:LIM:SEGM2:AMPL:STAR O;STOP 0” 
i 


! Set the frequency range for segment 2. 
QUIPUT @Hp87xx;"CALC1:LIM:SEGM2:FREQ:STAR 145 MHZ;STOP 200 MHZ" 
t 


! Create and turn on a third limit segment; 

! this one is a minimum limit. 

OUTPUT @Hp87xx;"CALC1:LIM:SEGM3:TYPE LMIN;STAT ON" 
' 


! Set the amplitude limits for segment 3. 
OUTPUT @Hp87xx;"CALC1:LIM:SEGM3:AMPL:STAR ~6;STOP ~6" 
t 


! Set the frequency range for segment 3. 
OUTPUT @Hp87xx;"CALC1:LIM:SEGM3:FREQ:STAR 150 MHZ;STOP 195 MH2" 
1 


! Create and set parameters for segment 4. 
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OUTPUT @Hp87xx;"CALC1:LIM:SEGM4: TYPE LMAX;STAT ON" 
OUTPUT @Hp87xx;"CALC1:LIM:SEGM4: AMPL:STAR ~60;STOP -60" 
OUTPUT @Hp87xx;"CALC1:LIM:SEGM4:FREQ:STAR 290 MHZ;STOP 400 MH2" 
t 
! Send an operation complete query to ensure that 
! all overlapped commands have been executed. 
OUTPUT @Hp87xx;"*0PC?" 
1 
! Wait for the reply. 
ENTER @Hp87xx;Opce 
! 
! Turn on the display of the limit lines. 
OUTPUT @Hp87xx;"CALC1:LIM:DISP ON" 
1 
! Turn on the pass/fail testing; watch the 
! analyzer’s display for the pass/fail indicator. 
CUTPUT @Hp87xx;"CALC1:LIM:STAT ON" 
7 
! Take a controlled sweep to ensure that 
! there is real data present for the limit test. 
OUTPUT @Hp87xx;"ABOR; :INIT1:CONT OFF; :INIT1;#WAI" 
i 
! Query the limit fail condition register to see 
! if there is a failure. 
OUTPUT GHp87xx;"STAT:QUES:LIM: COND?" 
i 
! Read the register’s contents. 
ENTER @Hp87xx;Fail_flag 
u 
! Bit O is the test result for channel 1 while 
! bit 1 is the results for channel 2 limit testing. 
IF BIT(Fail_flag,0)=1 THEN 
! 
! In case of failure, give additional direction 
! to the operator using the title strings. 
Title¢="Limit Test FAIL ~ Tune device" 
! 
! Turn on the title string. 
QUIPUT @Hp87xx;"DISP: ANN: TITL1:DATA METitle$a"’;STAT ON" 
' 


! Turn on continuous sweep mode for tuning. 


8-13 


2050 
2060 
2070 
2080 
2090 
2100 
2110 
2120 
2130 
2140 
2150 
2160 
2170 
2180 
2190 
2200 
2210 
2220 
2230 
2240 
2250 


2260 ! 


2270 
2280 
2290 
2300 
2310 
2320 
2330 


Example Programs 
Configuring Measurements 


OUTPUT @Hp87xx;"INIT1:CONT ON; *WAI" 


! Loop while the tuning is taking place. 
LOOP 


! Monitor the status of the limit fail 

! condition register. 
OUTPUT @Hp87xx; "STAT: QUES :LIM:COND?" 
ENTER @Hp87xx;Fail_flag 


! Check the limit fail bit. Exit if the 
! device has been tuned to pass the test. 
EXIT IF BIT(Fail.flag,0)=0 
END LOOP 
END IF 
i 
1 Turn off the prompt to the operator and 
! return the analyzer to the continuously 
! sweeping mode. 
OUTPUT @Hp87xx;"DISP:ANN:TITL1 OFF;:INIT:CONT ON; *WAr" 
END 


i 

Digs a a or odook aa ok ao AG ISI IOI RS Aaa AG IC I AE I ICR aC IR a ACA AIC ai A a 
! Iden port: Identify io port to use. 

! Description: This routines sets up the I/0 port address for 

u the SCPI interface. For "HP 87xx" instruments, 

' the address assigned to @Hp87xx = 800 otherwise, 
i 716. 

GE AS aK I ICID I ACIS ACR I aaa I CAE A aI A I a AAC 8 Ao CoE a a 
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2340 SUB Iden_pert 


2350 COM /Sys_state/ GHp87xx,Scode 
2360 ! 

2370 IF POS(SYSTEM$ ("SYSTEM ID") ,"HP 87")<>0 THEN 
2380 ASSIGN @Hp87xx TO 800 
2330 Scode=8 

2400 ELSE 

2410 ASSIGN @Hp87xx TO 716 
2420 Scode=7 

2430 END IF 

2440 ! 

2450 SUBEND !Iden_port 

2460 ! 
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POWERSWP Example Program 


This program demonstrates how to set up a power sweep. It shows how to 
query the instrument to determine its power sweep ranges, how to place a 
marker at a given stimulus power value (x-axis), how to read the measured 
power at a marker (y-axis) and how to read an entire trace of power sweep 
data. 


Filename: POWERSWEEP 


i 
i 
i 
! Description: Query the power sweep ranges, 
! take a power sweep, and use markers to read 
! gain at marker. Then query the trace. 

! 


DIM Trace_pwr(1:201) 
' 


COM /Sys_state/ @Hp87xx,Scode 
! Identify 1/0 Port 

CALL Iden. port 

t 


! Initialize the 871x; set to power sweep mode. 
! Set CH mode and freq. 


QUTIPUT GHp87xx; "SYST :PRESET ; *0PC?" 

ENTER CHp87xx; Ope 

QUTPUT @Hp87xx;"SENS1:FUNC ’XFR:POW 2’;DET BBAN; *WAI" 

OUTPUT @Hp87xx;"SENS1:FREQ:CENT 1 GHZ;*WAI" 

! Note that CW mode is set before Power-sweep mode 

OUTPUT @Hp87xx;"DISP : ANN: FREQ1: MODE CW; :SENS:FREQ:SPAN O HZ;*WAI" 
OUTPUT @Hp87xx;"POWER:MODE SWEEP; *WAI" 

i 


! Determine the Min/Max power settings for each 


! attenuator range. 
' 


FOR Atten=0 TO 60 STEP 10 
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OUTPUT @Hp87xx; "SOUR: POW: RANG ATT"&VAL$(CAtten)&" ;*WAT" 
QUTPUT @Hp87xx;"SOUR:POW:STAR? MIN" 
ENTER GHp87xx;Pwr min 
OUTPUT @Hp87xx;"SOUR:POW:STAR? MAX" 
ENTER @Hp87xx ; Pwr_max 
PRINT “Atten: ";Atten;" Min: ";Pwrimin;" Max: “;Pwr_max 
NEXT Atten 
E 
Fe me ee et rt 
! Find the optimum power sweep range, 
! defined as being that range for which either: 
! 1) Both the desired Start and Stop Power levels may be set, 
! 2) The desired Start Power may be set and the 
! Power Range is maximized. 
! Then, modify next 3 lines of code to get desired settings. 
Te ae ie ee ae A ee 
! Set Start and Stop power levels for power sweep. 
E 
CUTPUT @Hp87xx;"SOUR:POW:RANG ATTO;*WAI" 


QUTPUT CHp87xx;"SOUR:POW:STAR -2 DBM; *WAI" 

OUTPUT @Hp87xx;"SOUR:POW:STOP 4 DBM;+WAI" 

! Take one sweep, wait till done 

OUTPUT @Hp87xx;"ABOR;:INIT1:CONT OFF; :INIT1;*0PCT" 


! Read marker, display power in, power out, gain. 
! Note that the 

: X-axis is swept output power from the source, 
‘ Y-axis is power measured by the receiver. 

1 


OUTPUT @Hp87xx;"CALC1:MARK1 ON" 

! Set marker to start power, wait till done. 
OUTPUT @Hp87xx;"CALC1:MARK:K ~2;*0PC?" 
ENTER @Hp87xx; Ope 

! Read Marker Source power level and measured power. 
QUTPUT @Hp87xx;"CALC1:MARKi:X7" 

ENTER GHp87xx;Pwr_sre 

QUIPUT GHpS7xx;"CALC1:MARK1:Y?" 

ENTER @Hp87xx;Pwr_meas 

! Read entire trace array. 

OUTPUT @Hp87xx;"FORM:DATA ASC,3" 
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OUTPUT @Hp87xx;"TRAC? CHIFDATA" 


ENTER 
t 
PRINT 
PRINT 
PRINT 
PRINT 
END 


@Hp87xx;Trace_pwr(*) 


"Source Power @ Marker = "&VAL$(Pwr_src)&"dBm" 
“Received Power @ Marker = "&VAL$(Pwr_meas)£"dBm" 

“Gain @ Marker = "&VAL$(Pwr_meas-Pwr_src)&"dB" 

"Power Sweep Trace Point #1: “&VAL$(Trace_pwr(1))&"dBm" 


peodeia aI S OI IR aaa SS ICRI RI CIC IA ACK Aa A ACEI AI IO A IC 
! Iden_port: Identify io port to use. 
! Description: This routines sets up the I/0 port address for 


the SCPI interface. For "HP 87xx'' instruments, 
the address assigned to @CHp87xx = 800 otherwise, 
716. 


ego aaa RRR SSS GEG KG CII IISA I AEOI ACK AOR ARR IR aca a aOR oC a 
SUB Iden_port 
COM /Sys_state/ @Hp87xx,Scode 


IF POS(SYSTEM$ ("SYSTEM ID") ,"HP 87")<>0 THEN 


ASSIGN @Hp87xx TO 800 
Scode=8 
OUTPUT GHp87xx;"DISP:PROG LOWer" 


ELSE 


ASSIGN @Hp87xx TO 716 
Scode=7 


END IF 


SUBEND !Iden.port 
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Transfer of Data to/from the Analyzer 


MARKERS Transferring data using markers. The example also 
demonstrates the use of the query form of command 
mnemonics. 

& SMITHMKR Measures reflection of a filter in Smith chart and polar 
formats. 

ASCDATA Transferring data using the ASCII format. 


REALDATA Transferring data using the IEEE 64-bit floating point REAL 
format. The example also demonstrates block data transfers 
of both indefinite length and definite length syntax. Also 
demonstrated is access to the swapped-byte data format 
designed for PCs. 


INTDATA Transferring data using the 16-bit INTEGER format. 


FAST_CW Transferring marker data in CW measurement mode. 


& indicates HP 8712C/14C only 8-19 
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MARKERS Example Program 


This program demonstrates how to transfer measurement data by using the 
markers. Before any data is read over the HP-IB a controlled sweep should 
be taken. The analyzer has the ability to process and execute commands 
very quickly when they are received over the HP-IB. This speed can lead to 
commands (such as marker searches) being executed before any data has 
been taken. To ensure that the sweep has completed and the data is present 
before it is read, the command for a single sweep is used before data is 
requested. Note that *WAI is sent with that command. More information 
about making measurements with the analyzer is available in the User's 


Guide. 
1000 !Filename: MARKERS 
1010 ! 
1020 ! Description: 
1030 ! 1. Take sweep 
1040 ! 2. Set marker to 175 MHz, and query Y value 
1050 ! 3. Execute Marker -> Max, and query X and Y 
1060 | 4. Turn on marker tracking 
1070 | 5. Execute a 3 dB bandwidth search 
ioso ! 6. Query the result 
1090 ! 


1100 COM /Sys_state/ @Hp87xx,Scode 

1110 ! Identify 1/0 Port 

1120 CALL Iden_port 

1130 ! 

1140 ! 

1150 ! Turn on channel 1 and set up start and stop 

1160 ! frequencies for the example. These frequencies 

1170 ! were chosen for the demonstration filter that is 

1180 ! shipped with the analyzer. 

1190 OUTPUT @Hp87xx;"SENS1:STAT ON;FREQ:STAR 10 MHZ;STOP 400 MHZ;+*WAI" 
1200 | 

1210 ! Configure a transmission measurement on channel i 

1220 ! using the narrowband detection mode. 

1230 OUTPUT @Hp87xx;"SENS1:FUNC ’XFR:POW:RAT 2,0’ ;DET NBAN;*WAI" 
1240 ! 

1250 ! Take a single controlled sweep and have the 
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{ analyzer wait until it has completed before 

! executing the next command. 

QUTPUT @Hp87xx;"ABOR;:INIT:CONT OFF; : INIT; +*WarI" 
i 


! Turn on the first marker. 
OUTPUT @Hp87xx;"CALC1:MARK1 ON" 
i 


! Set marker 1 to a frequency of 175 MHz. 
QUITPUT @Hp87xx;"CALC1:MARK1:% 175 MHZ" 
i 


! Query the amplitude of the signal at 175 MHz. 
OUTPUT @Hp87xx;"CALC1:MARK1:Y?" 
i 


! Read the data; the data is in the NR3 format. 
ENTER GHp87xx;Data_1 

DISP "Marker 1 (175 MHz) = “;Data_i 

WAIT 5 

i 

! Turn on the second marker and use a marker 

! search function to find the maximum point 

! on the data trace. 

OUTPUT @Hp87xx;"CALC1:MARK2 ON;MARK2:MAX" 

1 


! Query the frequency and amplitude of the 

! maximum point. Note that the two queries can 
! be combined into one command. 

OUTPUT @Hp87xx;"CALC1:MARK2:X?;Y?" 

' 


! Read the data. 

ENTER @Hp87xx;Freq2,Data2 

! Display the results of the marker search. 
DISP "Max = ";Data2;"dB at";Freq2/1.E+6; "MHz" 
J 

! Put the analyzer into its continuously 

! sweeping mode. This mode works well for 

! tuning applications. 

OUTPUT GHp87xx;"INIT:CONT ON; *WAI" 

' 
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! Turn on the marker search tracking function. 
! This function causes the marker 2 to track 

! the maximum value each time the analyzer takes 
! a sweep. 

OUTPUT @Hp87xx;"CALC1:MARK2:FUNC: TRAC ON" 

WAIT 5 

iy 

! Turn off marker 2. 

QUIPUT @Hp87xx;"CALC1:MARK2 OFF" 

1 

! Take a single controlled sweep. 

OUTPUT GHp87xx;"ABOR; :INIT:CONT OFF; : INIT;#WaAI" 
f 

! Perform a search for the -3 dB bandwidth of 

! the filter. This function uses several 

! markers to find four key values. 

OUTPUT @Hp87xx;"CALC1:MARK:BWID -3;FUNC:RES?" 

1 


! Read the four values: the bandwidth, center 
! frequency, Q and the insertion loss. 

ENTER @Hp87xx;Bwid,Center_f,Q,Loss 

1 


! Display the results. 

DISP "BW: ";Bwid 

WAIT S 

DISP "Center Freq: “;Center_f 
WAIT 5 

DISP "Q: ";Q 

WAIT 5 

DISP "Loss: ";Loss 

t 

$ Turn off all the markers. 
OUTPUT @Hp87xx;"CALC1:MARK: AOFF" 


END 
' 


OUTTTItetrttrretetirer iron coon te te et eS ee eee te teeth 
! Iden_port: Identify io port to use. 

! Description: This routines sets up the I/O port address for 

! the SCPI interface. For "HP 87xx" instruments, 
! the address assigned to @Hp87xx = 800 otherwise, 
! 716. 
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2060 eG edo do iG a a crc aor aok a ok a aaa Ra RISK doa Rak ak oki ak ak a 
2070 SUB Iden_port 


2080 COM /Sys_state/ @Hp8/xx,Scode 
2090 ! 

2100 IF POS(SYSTEM$ ("SYSTEM ID") ,"HP 87")<>0 THEN 
2110 ASSIGN @Hp87xx TO 800 
2120 Scode=8 

2130 ELSE 

2140 ASSIGN @Hp87xx TO 716 
2150 Scode=7 

2160 END IF 

2170 ! 

2180 SUBEND !Iden_port 

2190 } 
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SSMITHMKR Example Program 


1000 !Filename: SMITHCHART 


1010 ! 

1020 ! 

1030 ! Description: Measures a 175MHz BPF using the 

1040 ! Smith and Polar plot formats. User must connect 

1050 ! the i75MHz filter between the reflection and transmission 

1060 ! ports. The program will do the following: 

1070 ! 1) Set analyzer to sweep over the filter’s passband (SOMHz) . 

1080 ! 2) Set analyzer to Smith Chart format; make a marker 

1030 ! reading (Frequency, Real Impedance in ohms, Imaginary 
Impedance 

1100 }! in ohms, Impedance Capacitance or Inductance); dump the 

1110 ! trace and print S11 Real and Imaginary values for the 

1120 ! first data point. 

1130 ! 3) Set analyzer to Polar Chart format; make a marker 

1140 ! reading (Frequency, Linear Magnitude in “units”, 

1150 ! Phase in degrees); dump the 

1160 ! trace and print S11 Real and Imaginary values for the 

i170 ! first data point. 

1180 ! 


1.190 lbleoie ae gisioist idiek dicts ide acca i ia SE 9 CR IC ACA CED 
1200 ! DEFINITIONS 

1210 ! 

1220 REAL Opc,Freq center, Freq_span,Freq_start ,Bpf_q,Bpf_loss 
1230 REAL Mrkr_freg,Mrkr res ,Mrkr reac ,Mrkr_ind 

1240 REAL Trace_s1i(1:201,1:2) ,Mrkr_mag ,Mrkr_phas 

1250 ! 

42.60 deaiciaicnieiaiak ioioicdok doa dedi sk toic desea ded oki ask ak ak ae aR i i toi oe 
1270 ! Determine computer type 

1280 ! 

1290 CLEAR SCREEN 

1300 ! 

1310 ! 

1320 COM /Sys_state/ @Hp87xx,Scode 

1330 ! Identify I/O Port 
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1340 
1350 
1360 
1370 
1380 
1390 
1400 
1410 


1420 
1430 


1440 
1450 
1460 
1470 


1480 
1490 


1500 


1510 


1520 


1530 ! 


1540 


1550 ! 


1560 
1570 


1580 


1590 


1600 
1610 


1620 
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Transfer of Data tolfrom the Analyzer 


CALL Iden_port 


f 

Ea ae am a a a a 

! Preset analyzer, set Center and Span frequencies 

1 

OUTPUT GHp87xx; "SYST: PRES ; xOPC?" !preset instrument 

ENTER @Hp87xx ;Ope twaits for PRESET to finish before 

proceeding. 

t 

! Center the filter’s frequency response (to get an accurate Bandwidth 
measurement) . 

4 

DISP "Setting analyzer frequencies..." tmessage to user 

QUTPUT @Hp87xx;"ABOR; -INIT:CONT OFF;:INIT;#O0PC?" !take a single sweep 

ENTER @Hp&87xx ; Ope ‘wait for sweep to 

finish 

OUTPUT @Hp87xx; "CALC1 :MARK: FUNC MAX; *WAI" fset Marker i to max 

OUTPUT @Hp87xx;"CALC1:MARK:X? ; *WAI" !get Marker frequency 

setting 

ENTER @Hp87xx ;Mrkr_freq fread frequency of max 

marker 

OUTPUT @Hp87xx;"SENS1:FREQ:CENT "&VAL$(Mrkr_freq)&" HZ;*WAI" !set 


Center Freq 
OUTPUT @Hp87xx;"SENS1:FREQ:SPAN 200 MHZ;*WAI" !set Span Freq = 200MHz 
1 


! Measure Bandwidth, set Center to band center, Span to SOMHz 
t 


OQUTPUT @Hp87xx;"ABOR; :INIT:CONT OFF;:INIT;*OPC?" !take a single sweep 
ENTER @Hp87xx ; Ope twait for sweep to 
finish 

OUTPUT @Hp87xx;"CALCL:MARK:FUNC BWID;*OPC?" 'search filter for -3dB 
bandwidth 

ENTER @Hp87xx; Ope twait for bandwidth to 
be found 

OUTPUT @Hp87xx;"CALC1:MARK: FUNC: RES?" tread the bandwidth data 
ENTER @Hp87xx;Freq_span,Freq_center ,Bpf_q,Bpf_loss !read 
in data 

OUTPUT @Hp87xx;"SENS1:FREQ:CENT "&VAL$(Freq_center)&" HZ;*WAI" tset 


Center Freq 
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1630 


1640 
1650 
1660 
1670 
1680 
1690 
1700 
1710 
1720 


1730 


1740 
1750 
1760 
1770 
1780 
1790 


1800 


1810 
1820 
1830 
1840 
1850 
1860 


1870 
1880 
1890 
1900 
1910 


1920 
1930 
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OUTPUT @Hp87xx;"SENS1:FREQ:SPAN 50 MHZ;*WAI" !set Span Freq to 5OMHZ 
(passband) 

\ 

t a ee ee a et tm 

! Set marker 1 to beginning of trace. 

5 

OUTPUT @Hp87xx;"'CALC1:MARK: AOFF ;+WAI" ‘clear all markers 
QUTPUT @Hp87xx; "CALCL:MARKI oN" {turn on marker i 
OUTPUT @Hp87xx;"SENS1:FREQ:STAR?" iget start frequency 
ENTER @Hp87xx ;Freq_start tenter start freq 
OUTPUT @Hp87xx; "CALC1:MARK1:% "SVAL$ (Freq_start)£";*OPC?" !set marker 


to start freq 
ENTER @Hp87xx ;Opc¢ twait for all previous 
commands to finish 


! Set to Reflection mode & Smith Chart format. 

E 

DISP "Setting to Smith Chart format..." 

OUTPUT @Hp87xx;"ABOR;:INIT1:CONT ON;*#WAI" set to Cont Sweep mode so 

can select reflection 

OUTPUT @Hp87xx;"SENS1:FUNC °XFR:POW:RAT 1,0°;DET NBAN; *WAI" 
ICHAN1=reflection 


QUTPUT @Hp87xx;"CALC1:FORM SMIT;+#WAI" tset smith chart format 
! 

1 ne se ee em ey ht a mt 

! Read marker information from Smith Chart. 

t 

OUTPUT @Hp87xx;"ABOR; : INIT: CONT OFF;:INIT;*0PC?" !force one sweep 


before read markers 


ENTER @Hp87xx ; Ope !wait for sweep to 
finish , 

QUTPUT @HpS7xx;"ABOR;:INITL:CONT ON; *WAI" 'set to Continuous Sweep 
mode 

OUTPUT GHp87xx;"CALC1:MARK:X?" tread marker frequency 
ENTER @Hp87xx;Mrkr_freq ‘units are in Hz 

OUTPUT @Hp87xx;'"'CALC1:MARK:Y:RES?" tread real part of 
marker impedance 

ENTER @Hp87xx;Mrkr_res ‘units are in ohms 
OUTPUT @Hp87xx;"CALC1:MARK:Y:REAC?" fread imaginary part of 


marker impedance 
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1940 
1950 


1960 
1970 


1980 
1990 


2000 ! 


2010 


2020 


2030 
2040 
2050 


2060 
2070 
2080 
2090 


2100 
2110 
2120 
2130 
2140 
2150 
2160 
2170 
2180 


2190 
2200 
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ENTER @Hp87xx ;Mrkr_reac lunits are in ohms 
OUTPUT @Hp87xx;"CALC1:MARK:Y: IND?" tread inductance (or 
capacitance) 
ENTER @Hp87xx ;Mrkr_ind lunits are Henries if positive value, Farads 
if negative 
1 
1 ee i i ee on et eee eS 
! Display Smith Marker data. 
i 
Mrkr_freq=DROUND (Mrkr_freq,3) tround frequency 
to 3 digits 
DISP "Smith Marker Frequency = "&VAL$(Mrkrfreq)&"Hz" !display 
frequency 
WAIT 3 
i 
Mrkr_res=DROUND (Mrkr_res ,3) ‘round resistance 
to 3 digits 
DISP "Smith Marker Resistance = "£VAL$(Mrkr_res)&" ohms" 
WAIT 3 
1 
Mrkr_reac=DROUND (Mrkr_reac ,3) tround reactance 
to 3 digits 
DISP "Smith Marker Reactance = "&VAL$(Mrkr_reac)&" ohms" 
WAIT 3 
1 
Mrkr_ind=DROUND (Mrkr_ind,3) 'round inductance 
to 3 digits 
IF Mrkr_ind<O THEN {label as 
capacitance if negative 
DISP "Smith Marker Capacitance = "&VAL$(-Mrkrind)&"F"! label 
capacitance 
ELSE 'label as 
inductance if positive 
DISP "Smith Marker Inductance = "&VAL$(Mrkr_ind)&"H® !label 
inductance 
END IF 
WAIT 3 
' 
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2220 
2230 
2240 


2250 


2260 
2270 
2280 
2290 


2300 


2310 
2320 
2330 
2340 


2350 
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2370 
2380 
2390 
2400 
2410 
2420 
2430 
2449 
2450 
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2470 
2480 


2490 


2500 ! 
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De ce ee ec ee te ee a a a et te 

! Read Smith Chart formatted trace data, display first data point. 

! Data is transferred in ASCII format with 3 significant digits. 

7 Si1 trace data is read out as: Real data for point #1, Imaginary 
data 

! for point #1, Real data for point #2, Imaginary data for point 
#2... 

! Since instrument was preset, number of trace data points 

! defaults to 201. 

t 

OUTPUT @Hp87xx;"FORM:DATA ASC,3;:TRAC? CHLFDATA" tset up to read 

ASCII data, 3 digits 

ENTER @Hp87xx;Trace_sili(*) tread trace data, 


real & imaginary pairs 
5) 


! Display data. 

t 

DISP "Smith Trace Point #1: S11(REAL) = "&VAL$(Trace.sii(1,1))&" 
Units" ‘display Real data 


WAIT 3 

DISP "Smith Trace Point #1: S11(IMAGINARY) = "&VAL$(Trace_sti(1,2))2" 
Units" ‘display Imaginary data 

WAIT 3 

t 

ERP EEEEEE EEE EEEEEEE EEL ERE EEE EE ERE EE EEE PEAS ET EET ETAT TEE EE 

! Set to Polar Chart Format, read Polar Markers. 

i 

DISP "Setting to Polar Format...” 


OUTPUT @Hp87xx;"CALC1:FORM POL; *WAI" tset polar chart format 
OUTPUT @Hp87xx;"CALC1:MARK:X?" tread marker frequency 
ENTER @Hp87xx ;Mrkr freq funits are in Hz 

QUIPUT @Hp87xx; "CALC1:MARK:Y:MAGN?" ‘read magnitude marker 
reflection coefficient 

ENTER @Hp87xx ;Mrkr_mag tmagnitude in "units" 
OUTPUT @Hp87xx;"CALC1:MARK:Y:PHAS?" ‘read phase of marker 
reflection coefficient 

ENTER @Hp87xx ;Mrkrphas lunits are in degrees 

E 
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2520 
2530 
2540 


2550 


2560 
2870 
2580 


2590 


2600 
2610 
2620 


2630 


2640 
2650 
2660 
2670 
2680 


2690 


2700 
2710 


2720 
2730 
2740 
2750 
2760 


2770 
2780 


2790 
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Ye re a ne ae a a ce a 

! Display Polar Marker data. 

! 

Mrkr_freq=DROUND (Mrkr_freq ,3) tround frequency 

to 3 digits 

DISP "Polar Marker Frequency = "&VAL$(Mrkr_freq)&"H2" 'display 

frequency 

WAIT 3 

i 

Mrkr_mag=DROUND (Mrkr_mag,3) fround magnitude 

to 3 digits 

DISP "Polar Marker Magnitude = "&VAL$(Mrkr_mag)&" Units" 'display 

magnitude 

WAIT 3 

u 

Mrkr_phas=DROUND (Mrkr_phas ,3) tround phase to 3 

digits 

DISP "Polar Marker Phase = "&VAL$(Mrkr_phas)&" Degrees" idisplay 

phase 

WAIT 3 

i 

Vm a i ea a a 0 

! Read Polar Chart trace data, display first data point. 

! S11 trace data is read out as: Real data for point #1, Imaginary 
data 

! for point #1, Real data for point #2, Imaginary data for point 
eee 

rf 

QUTPUT GHp87xx;"FORM:DATA ASC,3;:TRAC? CHIFDATA" {set up to read 

ASCII data, 3 digits 

ENTER GHp87xx;Trace_sii(*) tread trace data, 


real & imaginary pairs 

) 

! Display data 

4 

DISP "Polar Trace Point #1: S11(REAL) = “&VAL$(Trace_s11(1,1))&" 
Units" i!display Real data 

WAIT 3 


DISP “Polar Trace Point #1: S11(IMAGINARY) = "&VAL$(Trace.s11(1,2))&" 
Units" ‘!display Imaginary data 
WAIT 3 
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2800 


2810 
2820 
2830 
2840 
2850 
2860 
2870 
2880 
2890 
2900 
2910 
2920 
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2940 ! 


2950 
2960 
2370 
2980 
2990 
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3010 
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DISP "" tclear display 
Line 

t 

stop 

END 

! 

Doak coogi aa aC ISI ICICI I aCIC A IO a a IA A aR a I ok aE 
! Iden_port: Identify io port to use. 

! Description: This routines sets up the I/0 port address for 

H the SCPI interface. For "HP 87xx" instruments, 
1 the address assigned to @Hp87xx = 800 otherwise, 
! 716. 

Doe SE AO SOA ISI OR Aaa IO II IA a A A aE 1 ak 1 OE A 0K 36k 
SUB Iden_port 


COM /Sysstate/ @Hp87xx ,Scode 
3 

IF POS(SYSTEM$("SYSTEM ID") ,"HP 87')<>0 THEN 
ASSIGN GHp87xx TO 800 
Scode=8 

ELSE 
ASSIGN CHp87xx TO 716 
Scode=7 

END IF 


i 


SUBEND !Iden_port 
t 
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1000 
1010 
1020 
1030 
1040 
1050 
1060 
1070 
1080 
1090 
1100 
1110 
1120 
1130 


1140 ! 


1150 
1160 
1170 


1180 ! 


1190 
1200 
1210 


1220 ! 


1230 
1240 
1250 
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ASCDATA Example Program 


This program demonstrates how to read data arrays from the analyzer 
and write them back again. The ASCii data format is being used with a 
resolution of 5 digits. More information about data transfer is available 
in Chapter 4, “Data Types and Encoding,” and Chapter 6, “Trace Data 
Transfers.” 


In addition to the channel 1 formatted data array used in this example, there 
are a number of arrays that can be accessed inside the instrument. These 
arrays and their corresponding mnemonics are listed in Chapter 6 in Table 6-4 
and Table 6-5. 


Filename: ASCDATA 


E 
! Description: 

! 4. Takes a sweep, and reads the formatted 

! data trace into an array. The trace 

: is read as a definite length block. 

$ 2. Instructs you to remove DUT. 

! 3. Downloads the trace back to the analyzer 
t as an indefinite length block. 

REAL Datal(1:51) 

! 

cOM /Sys_state/ @Hp87xx,Scode 

! Identify 1/0 Port 

CALL Iden_port 


E 

! 

! Set the analyzer to measure 51 data points. 
OUTPUT GHp87xx;"SENSi:SWE:POIN 51;*WAI" 

i 

! Take a single sweep, leaving the analyzer 

! in trigger hold mode. 

OUTPUT @Hp87xx;"ABOR; :INITi:CONT OFF; :INIT1;*WAI" 
1 

! Set up the ASCII data format with 5 

! significant digits 

CUTPUT @Hp87xx;"FORM:DATA ASC,5" 
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1370 
1380 
1390 
1400 
1410 
1420 
1430 
1440 
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1530 ! 


1540 
1550 
1560 
1570 
1580 
1590 
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1610 
1620 
1630 
1640 
1650 
1660 
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! 

! request the channel 1 formatted data array 
! from the instrument. 

OUTPUT @Hp87xx; "TRAC? CHIFDATA" 

i 


! Get the data and put into data array Datal. 
ENTER @Hp87xx;Data1(*) 
1 


! Display the first 3 numbers in the array. 
DISP "Trace: ";Datai(1);Data1(2);Datai(3);"..." 
i 


! Use the wait time to visually compare the 

! numbers to the visible data trace. 

WAIT 5 

i 

! Prompt the operator to disconnect the test 

! device and then how to continue the program. 

DISP "Disconnect the test device -- Press Continue" 
PAUSE 

i 


! Update the display line. 
DISP "Taking a new sweep..."; 
i 


! Take a sweep so the display shows new data. 
OUTPUT GHp87xx;":INIT1;*WAI" 

DISP " Done." 

WAIT 5 

E 

! Prepare the analyzer to receive the data. 
! Suppress the "end" character by using a 

! semicolon at end of output statement. 
DISP "Downloading saved trace..."; 

OUTPUT @Hp87xx;"TRAC CHIFDATA"; 

‘i : 


! Send the data array one point at a time, 
! using the semicolon at the end of the 
! output statement to suppress the 
! end character. 
FOR I=1 TO Si 
OUTPUT GHp87xx;", ";Datai(I); 
NEXT TI 
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1670 
1680 
1690 
1700 
1710 
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1820 ! 


1830 
1840 
1850 
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1880 
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1900 ! 


1910 
1920 
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' 
! Now send the end character. 
QUTPUT @Hp87xx;"" 
DISP " Done!" 
END 
Diba GEARS R Aa SASHA GS ISCO IO SIGIR a Ir I a a ACK a5 aa a Aa 
! Iden port: Identify io port to use. 
! Description: This routines sets up the I/0 port address for 
f the SCPI interface. For "HP 87xx" instruments, 
u the address assigned to @Hp87xx = 800 otherwise, 
! 716. 
Ip OSA A A SO OK KIOR IOGEAR g aa oa aR: dk a a AOE 
SUB Iden_port 
COM /Sys_state/ @Hp87xx ,Scode 
1 
IF POS(SYSTEM$ ("SYSTEM ID") ,"HP 87")<>0 THEN 
ASSIGN @Hp87xx TO 800 
Scodes8 
ELSE 
ASSIGN @Hp87xx TO 716 
Scode=7 
END IF 
i 


SUBEND !Iden_port 
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1000 
1010 
1020 
1030 
1040 
1050 
1060 
1070 
1080 
1030 
1100 
1110 
1120 


1130 ! 


1140 


1150 ! 


1160 
1170 
1180 
1190 
1200 
1210 
1220 
1230 
1240 
1250 
1260 
1270 
1280 
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REALDATA Example Program 


This program demonstrates how to read data arrays from the analyzer and 
write them back again. The REAL, 64 data format is being used. Note that 
the analyzer outputs the data using the definite length block syntax. This 
example uses the indefinite length block syntax when data is being written 
back to the analyzer. More information about data transfer is available 

in Chapter 4, “Data Types and Encoding.” All of the arrays listed in the 
ASCDATA example section can also be accessed using this data format. 


!Filename: REALDATA 


1 
! Description: 

1 41. Takes a sweep, and reads the formatted 

! data trace into an array. The trace 

u is read as a definite length block. 

! 2. Instructs you to remove DUT. 

! 3. Downloads the trace back to the analyzer 
B as an indefinite length block. 

DIM A$[10] ,Datal(i:51) 

INTEGER Digits ,Bytes 

1 


COM /Sys_state/ @Hp87xx,Scode 
Identify I/¢ Port 

CALL Iden port 

t 


! Set up the analyzer to measure 51 data points. 
OUTPUT @Hp87xx;"SENS1:SWE:POIN 51;*WAI" 
1 


! Take a single sweep, leaving the analyzer 

! in trigger hold mode. 

QUTPUT @Hp87xx;"ABOR;:INIT1:CONT OFF; :INIT1;*WAI" 
! 

! Select binary block transfer. 

OUTPUT @Hp87xx;"FORM:DATA REAL ,64" 

t 

! Request the channel 1 formatted data array 

! from the analyzer. 
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1290 
1300 
1310 
1320 
1330 
1340 
1350 
1360 
1370 
1380 
1390 
1400 
1410 
1420 
1430 
1440 
1450 
1460 


1470 } 


1480 
1490 
1500 
1510 


1520 ! 


1530 
1540 


1550 ! 


1560 
1570 


1580 ! 


1590 
1600 


1610 ! 


1620 
1630 


1640 ! 


1650 
1660 
1670 
1680 
1690 
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OUTPUT @Hp87xx;"TRAC? CH1IFDATA" 

1 

! Turn on ASCII formatting on the I/O path. 
! It is needed for reading the header 

! information. 

ASSIGN @Hp87xx;FORMAT ON 

1 


! Get the data header. "A$" will contain the 

! "#" character indicating a block data transfer. 
! "Digits" will contain the number of characters 
! for the number of bytes value which follows. 
ENTER @HpS7xx USING "%,4,D";A$ Digits 


t 
! Get the rest of the header. The number of 
i bytes to capture in the data array will be 
! placed in "Bytes". Wote the use of "Digits" 
! in the IMAGE string. 

ENTER @Hp87xx USING "%,"&VAL$(Digits)&"D"; Bytes 
1 

! Turn off ASCII formatting on the I/0 path; 

! it is not needed for transferring binary 

! formatted data. 

ASSIGN @Hp87xx;FORMAT OFF 

I 

! Get the data. 

ENTER @Hp87xx ;Datal(*) 

1 

! Turn on ASCII formatting again. 

ASSIGN @Hp87xx;FORMAT ON 

1 

$ Get the "end of data" character. 

ENTER @Hp87xx; A$ 

i 

! Display the first three numbers in the array. 
DISP "Trace: ";Datai(1);Datai(2) ;Datal(3);"..." 
i 

! Use this time to visually compare the 

! numbers to the visible data trace. 

WAIT 5 

i 

! Prompt the operator to disconnect the test 
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| device and how to continue the program. 

DISP "Disconnect the test device -- Press Continue" 
PAUSE 

! 

! Update the display line. 

DISP "Taking a new sweep..."; 

1 

! Take a sweep so the display shows new data. 
OUTPUT @Hp87xx;": INITL;*WAI" 

DISP " Done.” 

WAIT 5 

t 

! Send the header for an indefinite block length 
! data transfer. 

DISP "Downloading saved trace..."; 


QUIPUT @Hp87xx;"TRAC CHIFDATA, #0"; 
1 


! Turn off ASCII formatting. 

ASSIGN @Hp87xx;FORMAT OFF 

t 

! Send the data array back to the analyzer. 
OUTPUT @Hp87xx;Datai(*) ,END 

1 


! Turn on ASCII formatting again. 


ASSIGN @Hp87xx;FORMAT ON 

DISP " Done!" 

END 

i 

Dg SE EC OEIGO ORR ISG AG RCAC IE I aK aa ARR a Ik a isk ak a faketciok ai a ak 
! Iden_port: Identify io port to use. 

! Description: This routines sets up the I/0 port address for 

I the SCPI interface. For "HP 87xx" instruments, 

it the address assigned to @Hp87xx = 800 otherwise, 
1 716. 

Dba aon o  Ranio ccioeiabacioidcesakik i fai a ak ekcieak ak ik ae ek ak ak eg eae 
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2050 SUB Iden_port 


2060 CoM /Sys_state/ CHp87xx ,Scode 
2070 ! 

2080 IF POS(SYSTEM$("SYSTEM ID") ,"HP 87")<>0 THEN 
2090 ASSIGN @Hp87xx TO 800 
2100 Scode=8 

2110 ELSE 

2120 ASSIGN @Hp87xx TO 716 
2130 Scode=7 

2140 END IF 

2150 ! 

2160 SUBEND !Iden_port 

2170 ! 
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INTDATA Example Program 


This program demonstrates how to read data arrays from the analyzer and 
write them back again. The INTeger,16 data format is being used. This data 
format is the instrument’s internal format. It should only be used to read 
data that will later be returned to the instrument. 


The data array dimensioned in line 1100 is different from the arrays in either 
REAL,64 or ASCii examples. This is because each data point is represented 
by a set of three 16-bit integers. Another difference in using this data format 
is that all arrays cannot be accessed with it. The formatted data arrays 
CHIFDATA and CH2FDATA cannot be read using the INTEGER format. 


Note that the analyzer outputs the data using the definite length block 
syntax. This example uses the indefinite length block syntax when data is 
being written back to the analyzer. More information about data transfer is 
available in Chapter 4, “Data Types and Encoding.” 


'Filename: INTDATA 


' 
! Description: 

! 4. Takes a sweep, and reads the formatted 

! data trace into an array. The trace 

} is read as a definite length block. 

! 2. Instructs you to remove DUT. 

! 3. Downloads the trace back to the analyzer 
y as an indefinite length block. 

DIM A$[10] 

INTEGER Digits ,Bytes ,Datai(1:51,1:3) 

' 


COM /Sys_state/ @Hp87xx,Scode 
! Identify 1/0 Port 

CALL Iden_port 

! 


: 

! Set up the analyzer to measure 51 data points. 
OUTPUT @Hp87xx;"SENS1:SWE:POQIN 51;*WAI" 

t : 


! Take a single sweep, leaving the analyzer 
! in trigger hold mode. 
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1220 
1230 
1240 
1250 
1260 
1270 
1280 
1290 
1300 
1310 
1320 
1330 
1340 
1350 
1360 
1370 
1380 
1390 
1400 
1410 
1420 
1430 
1440 
1450 
1460 
1470 
1480 
1490 
1500 
1510 
1520 
1530 


1540 ! 


1550 
1560 
1570 
1580 
1590 
1600 
1610 
1620 
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QUTPUT @Hp87xx;"ABOR; : INIT1:CONT OFF; : INIT1; *War" 
t 

! Select binary block transfer 

OUTPUT GHp87xx;"FORM:DATA INT,16" 

1 


! Request the channel 1 unformatted data array 
! from the analyzer. 

QUTPUT @Hp87xx; "TRAC? CHiSDATA" 

' 


‘ Turn on ASCII formatting on the I/0 path; 

! it is needed for reading the header information. 
ASSIGN @Hp87xx;FORMAT ON 

1 


! Get the data header. "A$" will contain the 

! “#" character indicating a block data transfer. 
! "Digits" will contain the number of characters 
! for the number of bytes value which follows. 
ENTER @Hp87xx USING "%,A,D";A$,Digits 
1 
t 
1 
t 
t 


Get the rest of the header. The number of 
bytes to capture in the data array will be 
placed in "Bytes". Note the use of "Digits" 
in the IMAGE string. 
ENTER @Hp87xx USING "%,,"&VAL$(Digits)&"D" ;Bytes 
t 


! Turn off ASCII formatting on the I/0 path; 
! it is not needed for transferring binary 

$ formatted data. 

ASSIGN @Hp87xx;FORMAT OFF 

' 


! Get the data. 
ENTER @CHp87xx;Datai(*) 
1 


! Turn on ASCII formatting again. 


ASSIGN @Hp&87xx;FORMAT ON 
i 


! Get the "end of data" character. 
ENTER @Hp87xx; A$ 
! 


! Display the first 3 numbers; there will 
! be no visible similarity between these 
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1630 ! numbers and the data displayed on the 
! analyzer. 


1640 
1650 
1660 
1670 
1680 
1690 
1700 
1710 
1720 
1730 
1740 
1750 
1760 
1770 
1780 
1790 
1800 
1810 
1820 
1830 
1840 
1850 
1860 
1870 
1880 
1890 
1900 


1910 ! 


1920 
1930 
1940 
1950 
1960 
1970 
1980 
1990 


2000 ! 
2010 ! 
2020 ! 


2030 


DISP "Trace: ";Datai(1,1);Data1(1,2) ;Datai(1,3);"..." 
WAIT 5 

t 

! Prompt the operator to disconnect the test 

! device and how to continue the program. 

DISP "Disconnect the test device -- Press Continue” 
PAUSE 

' 

! Update the display line. 


DISP "Taking a new sweep..."3 
1 


! Take 
OUTPUT 
DISP " 
WAIT 5 
1 

! Send 
! data 


a sweep so the display shows new data. 
QHp87xx ;": INITL; WAI" 
Done.” 


the header for an indefinite block length 
transfer. 


DISP "Downloading saved trace..." 


OUTPUT 
i 

! Turn 
ASSIGN 
1 

! Send 
OUTPUT 
t 

! Turn 
ASSIGN 


@Hp87xx;"TRAC CHISDATA, #0"; 


off ASCII formatting. 
@HpS7xx; FORMAT OFF 


the data back to the analyzer. 
@Hp87xx ;Datai(*) ,END 


on ASCII formatting. 
@Hp87xx; FORMAT ON 


DISP "Done!" 


END 
i 


[RG SAGO IO FO IOS I I RS IC A ICI ak EI OR aR ACE a AC A EA ao oe a oe a ook ok a ea 
! Iden_port: Identify io port to use. 
! Description: This routines sets up the 1/0 port address for 


i 
t 
iy 


the SCPI interface. For “HP 87xx" instruments, 
the address assigned to @Hp87xx = 800 otherwise, 
716. 


Daa GA a I A A a i ak ake i ik dak a aca af of a rok fk aioe i ak ok ok ak ak a ok i aa i a a IC i a 
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2040 SUB Iden_port 


2050 COM /Sys.state/ @Hp87xx ,Scode 
2060 ! 

2070 IF POS(SYSTEM$ ("SYSTEM ID") ,"HP 87")<>0O THEN 
2080 ASSIGN GHp87xx TO 800 
2090 Scode=8 

2100 ELSE 

2110 ASSIGN @Hp87xx TO 716 
2120 Scode=7 

2130 END IF 

2140 ! 

2150 SUBEND !Iden_port 

2160 ! 
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FAST_CW Example Program 


This program demonstrates how to set up a CW (fixed frequency) sweep with 
the minimum number of trace points. Such a sweep allows measurements 

to made very rapidly. The program also shows how to set up a loop which 
uses a fast CW sweep, reads a marker value on the measurement trace, then 
changes the CW frequency. 


1000 
1010 
1020 
1030 
1040 
1050 
1060 
1070 
1080 
1030 
1100 
1110 
1120 
1130 
1140 
1150 


1160 ! 


1170 
1180 
1190 
1200 


1210 ! 


1220 
1230 
1240 
1250 
1260 


Filename: FAST.CW 


1 
! 
! Description: 

! Set sweep to CW, and select the 

! fewest number of points. 

3 Change the frequency, take a sweep, 
Hy and use a marker to read the trace. 
! Repeat as quickly as possible. 

i 


DIM Freq_str$[20] 
DIM Msg$[100] 
! 


t 

cOM /Sys_state/ @Hp87xx ,Scode 
! Identify I/0 Port. 

CALL Iden port 

' 


! 

! PRESET, to ensure known state. 
OUTPUT @Hp87xx;"SYST:PRES ;*WAI" 
CLEAR SCREEN 

i 


! Set up the analyzer to measure 3 data points. 
OUTPUT @Hp87xx;"SENS1:SWE:POIN 3;*WAI" 
! 


! Select CW display and sweep. 
OUTPUT @Hp87xx;"DISP:ANN:FREQ1:MODE CW" 


1270 OUTPUT @Hp87xx;"SENS1:FREQ:SPAN O Ha;*WAI" 
1280 ! 
1290 ! Take a single sweep, leaving the analyzer 
1300 ! in trigger hold mode. 
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1310 OUTPUT @Hp87xx;"ABOR;:INITi:CONT OFF; *WAI" 
1320 ! 

1330 ! Turn on Marker 1 

1340 OUTPUT @Hp87xx;"CALC:MARKi ON" 

1350 ! 

1860 Count=0 

1370 TO=TIMEDATE 

1380 ! Step from 175 MHz 463 MHz by 6 MHz 

1390 FOR Freq=175 TO 463 STEP 6 


1400 ! Take a sweep 

1410 Freq_str$=VAL$(Freq)&" MHz" 

1420 OUTPUT @Hp87xx;"SENS1:FREQ: CENT "Freq str$ 
1430 OQUTIPUT @Hp87xx;"INIT1;*WAI" 

1440 ! 

1450 ! Set marker to frequency 

1460 QUTPUT @Hp87xx;"CALC:MARK:% "> Freq str$ 
1470 : 

1480 ! Query the marker value 

1490 OUTPUT @Hp87xx;"CALC:MARK:Y?" 

1500 ENTER @Hp87xx;Response 

1510 i 

1520 ! Display the first three numbers in the array. 
1630 Msg$="""@Freq_str$z": “&VAL$ (Response) &"?" 
1540 OUTPUT @Hp87xx;"DISP:ANN:MESS ";Msg$ 

1550 PRINT Nsg$ 

1560 Count=Count+i 


1570 NEXT Freq 

1580 T1=TIMEDATE 

1590 PRINT "Sweeps per second: “;Count/(T1-TO) 
1600 DISP "Sweeps per second: ";Count/(Ti-TO) 
41610 END 

1620 ! 
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1630 
1640 
1650 
1660 
1670 
1680 
1690 
1700 
1710 


1720 ! 


1730 
1740 
1750 
1760 
1770 
1780 
1790 
1800 
1810 
1820 
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Dggaa kia ka io aokiobrn aaa EI aI aA IARI KAA I CE I ICE ao i i ok aE 

Iden port: Identify io port to use. 

Description: This routines sets up the I/0 port address for 
the SCPI interface. For "HP 87xx" instruments, 
the address assigned to @Hp87xx = 800 otherwise, 

! 716. 

Dgkge doi oko aioiiiok oink ie ib ci i doa aaa kA ori a api ak aaa i ra ak 

SUB Iden_port 

COM /Sys_state/ @Hp87xx,Scode 


IF POS(SYSTEM$ ("SYSTEM ID") ,"HP 87")<>0 THEN 
ASSIGN @Hp87xx TO 800 
Scode=8 
ELSE 
ASSIGN @Hp87xx TO 716 
Scode=7 
END IF 


1 


SUBEND !Iden_port 
' 
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Calibration 


TRANCAL 


REFLCAL 


LOADCALS 


CALKIT 


Performing a transmission calibration. The calibration is 
User Defined (performed over the instruments current 
source settings). This example also demonstrates the use of 
the *OPC? coramand. 


Performing a reflection calibration. The calibration is Full 
Band (performed over the instrument’s preset source 
settings). This example also demonstrates the detection of 
front panel key presses, the use of softkeys, and the use of 
the *OPC? command. 


Uploading and downloading correction arrays. The data 
transfer is perforrned in the 16-bit integer format. The 
arrays must be dimensioned properly for both the number of 
data points and the format of the data being transferred. 


Instrument state file for downloading User Defined cal 

kit definitions. This example is NOT a program. It is an 
instrument state file example. This type of file enables the 
user to calibrate the analyzer for use with connector types 
that are not in the firmware. See “Writing and Editing Your 
Own Cal Kit File” in Chapter 6 of the User’s Guide. 
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1000 
1010 
1020 


1030 ! 


1040 
1050 
1060 
1070 


1080 ! 


1030 
1100 
1110 
1120 
1130 
1140 
1150 
1160 
1170 
1180 
1190 
1200 


1210 ! 


1220 
1230 
1240 
1250 
1260 
1270 
1280 
1290 
1300 


Example Programs 
Calibration 


TRANCAL Example Program 


This program demonstrates a transmission calibration performed over 
user-defined source settings (frequency range, power and number of points). 
The operation complete query is used at each step in the process to make 
sure the steps are taken in the correct order. More information on calibration 
is available in the User’s Guide. 


! Filename: TRANCAL 
' 


! Guide user through a transmission cal. 
1 

2 

CoM /Sys_state/ QHp87xx,Scode 

! Identify I/O Port 


CALL Iden port 
' 


: 

! Configure the analyzer to measure transmission 

' on channel 1. 

OUTPUT @Hp87xx;"SENS1:FUNC ’XFR:POW:RAT 2,0°?;DET NBAN;*WAI" 
E 

! Select a calibration kit type. 

OUTPUT @Hp87xx;"SENS:CORR:COLL:CKIT °COAX,7MM,TYPE-N,50, FEMALE?" 
‘ 

! Select a transmission calibration for the current 
! analyzer settings. The “IST:OFF" ensures that 

! the current settings will be used. 

OUTPUT @Hp87xx;"SENS1:CORR:COLL:IST OFF;METH TRAN1" 
t 

! Prompt the operator to make a through 

! connection. 

DISP "Connect THRU - Press Continue" 

PAUSE 

DISP "Measuring THRU" 

iJ 

! Analyzer measures the through. 

OUTPUT @Hp87xx;"SENS1:CORR:COLL STAN1;*OPC?" 
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1310 
1320 
1330 
1340 
1350 
1360 
1370 
1380 
1390 
1400 
1410 


1420 ! 


1430 
1440 
1450 
1460 
1470 


1480 


1490 
1500 
1510 
1520 
1530 
1540 
1550 
1560 
1570 
1580 
1590 
1600 
1610 
1620 
1630 
1640 
1650 
1660 
1670 


1680 ! 
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! Wait until the measurement is complete. 
ENTER @Hp87xx; Ope 

DISP "Calculating Error Coefficients” 

1 

! Tell the analyzer to calculate the 

! error coefficients after the measurement 
! is made, and then save for use during 

! subsequent transmission measurements. 

! Note that this is not the same as using 
i the SAVE RECALL key functionality. 
QUTPUT @Hp87xx; "SENS1:CORR:COLL:SAVE;*0PC?" 
i 


! Wait for the calculations and save to be 

! completed. 

ENTER @Hp87xx; Ope 

DISP “User Defined TRANSMISSION CAL COMPLETED!" 
END 


t 
Werrrerrttiticritirrcocrr rece Sr ett eee et 
! Iden_port: Identify io port to use. 

! Description: This routines sets up the 1/0 port address for 

{ the SCPI interface. For "HP 87xx" instruments, 
! the address assigned to @Hp87xx = 800 otherwise, 


: 716. 
t FOR IRR AR IOI EEE I OK aI ICS Se a ak akc aR ok fk ae a ke 2k of 2 ake 2 2 2 oi 2 ie ia a ee a aco a a 2 2 


SUB Iden_port 
cOM /Sys_state/ GHp87xx,Scode 
1 
IF POS(SYSTEM$("SYSTEM ID") ,“HP 87")<>0 THEN 
ASSIGN @Hp87xx TO 800 
Scodes8 
ELSE 
ASSIGN @Hp87xx TO 716 
Scode=7 
END IF 


SUBEND !Iden_port 
i 
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1000 
1010 
1020 
1030 
1040 
1050 
1060 
1070 
1080 


1080 ! 


1100 
1110 
1120 
1130 
1140 
1150 
1160 
1170 
1180 
1190 
1200 
1210 
1220 
1230 
1240 
1250 
1260 
1270 
1280 
1290 
1300 
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REFLCAL Example Program 


This program demonstrates a reflection calibration performed over the 
preset source settings (frequency range, power and number of points). The 
operation complete query is used at each step in the process to make sure 
the steps are taken in the correct order. More information on calibration is 
available in the User’s Guide. 


!Filename: REFLCAL 
+ 


! Guide user through a reflection cal. 
i 


DIM Nsg$ [50] 
' 


com /Sys_state/ @Hp87xx,Scode,Internal 
! Identify I/0 Port 

CALL Iden_port 

1 


! Configure the analyzer to measure 

! reflection on channel 1. 

OUTPUT @Hp87xx;"SENSi:FUNC ’XFR:POW:RAT 1,0°;DET NBAN; +*WAI" 
' 


! Select Calibration Kit for 50 ohm instruments. 

OUTPUT @Hp87xx;"SENS:CORR:COLL:CKIT ’COAX,7MM,TYPE-N,50, FEMALE?" 

t 

Select Calibration Kit for 75 ohm instruments. 

(Comment out the 50 ohm line above and uncomment the line 
below.) 

QCUTPUT GHp87xx;"SENS:CORR:COLL:CKIT *COAX,7MM,TYPE-N,75,FEMALE’" 


Select a reflection calibration for the current 
analyzer settings. The "IST:OFF" ensures that 
current settings will be used. 

QUIPUT @Hp&7xx;"SENS1:CORR:COLL: IST OFF;METH REFL3" 
1 


! Prompt the operator to connect an open. 
Msg$="Comnect OPEN" 
GOSUB Get_continue 
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1310 


1320 ! 


1330 
1340 
1350 
1360 
1370 
1380 
1330 
1400 
1410 
1420 
1430 
1440 
1450 
1460 
1470 
1480 
1490 
1500 
41510 
1520 
1530 
1540 
1550 
1560 
1570 
1580 
1690 
1600 
1610 
1620 
1630 
1640 
1650 
1660 
1670 
1680 
1690 
1700 
1710 
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DISP "Measuring OPEN" 

r 

! Measure the open. 

QUTPUT @Hp87xx;"SENS1:CORR:COLL STAN1;*#0PC?7" 
i 


! Wait until the measurement of the open 
! is complete. 

ENTER @Hp87xx;Ope 

r 


! Prompt the operator to connect a short. 
Msg$="Connect SHORT" 

GOSUB Get_continue 

DISP "Measuring SHORT" 

t 

! Measure the short. 

OUTPUT @Hp87xx;"SENS1:CORR:COLL STAN2;*0PC?" 
1 


! Wait until measurement of the short 
! is complete. 

ENTER @Hp87xx;Opc 

i 


! Prompt operator to connect a load. 
Msg$="Connect LOAD" 

GOSUB Get_continue 

DISP "Measuring LOAD" 

t 

! Measure the load. 

QUTPUT @Hp87xx;"SENS1:CORR:COLL STAN3;*0PC?" 
! Wait until measurement of the load 

! is complete. 

ENTER @Hp87xx;Qpc 

DISP "Calculating Error Coefficients" 

1 

! Tell the analyzer to calculate the 

' error coefficients, and then save 

! for use during subsequent reflection 

! measurements. Note that this is not 

! the same as using the SAVE RECALL key 

! functionality. 

OUTPUT GHp87xx;"SENS1:CORR:COLL:SAVE; *OPC?" 
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1720 
1730 
1740 
1750 
1760 
1770 
1780 
1790 
1800 
1810 
1820 
1830 
1840 
1850 
1860 
1870 


1880 ! 
1890 $ 


1900 
1910 
1920 
1930 


1950 
1960 
1970 
1980 
1990 
2000 
2010 
2020 
2030 
2040 
2050 
2060 
2070 
2080 
2090 
2100 
2110 
2120 


Examp 


le Programs 


Calibration 


! Wait for the calculations to be completed 
! and the calibration saved. 

ENTER @Hp87xx ;Opc 

DISP "Full Band REFLECTION CAL COMPLETED!" 
STOP 


Get_continue: ! Subroutine to handle operator prompts. 


"Internal" is determined above based on the 
! controller. 
IF Internal=1 THEN 


If int 
line f 
DISP 


Use th 
while 


ernal control, then use the display 
or the prompt. 
Msg$&k" - Press Measure Standard" 


e softkey 2 for the response; loop 
waiting for it to be pressed. 


ON KEY 2 LABEL "Measure Standard" RECOVER Go_on 


Loop 


END LOOP 


ELSE 
1940 ! 


If ext 


! so pre 


ernal control, clear the key queue 
vious key presses will not interfere. 


OUTPUT GHp87xx; "SYST: KEY: QUE: CLE" 


Use th 
DISP 


Turn o: 
presse 


e BEGIN key for the response. 
Msg$k" ~ Press BEGIN to continue” 


m the key queue to trap all key 
Ss. 


OUTPUT @Hp87xx;"SYST:KEY:QUE ON" 


Loop wi 
presse 

LOOP 
Query 
regist 


hile waiting for a key to be 
d. 


the device status condition 

er. 

OUTPUT CHp87xx;"STAT: DEV: COND?" 
ENTER @Hp87xx;Dev_cond 
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2130 
2140 
2150 
2160 
2170 
2180 
2190 
2200 
2210 
2220 
2230 
2240 
2250 
2260 
2270 
2280 
2290 
2300 
2310 
2320 
2330 
2340 
2350 
2360 
2370 
2380 
2390 
2400 
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! 
! Check the bit that indicates a key press. 
IF BIT(Dev_cond,0)=1 THEN 
OUTPUT @Hp87xx; "SYST: KEY?" 
ENTER @Hp87xx ;Key..code 
END IF 

1 
! Stop looping if the BEGIN key was pressed. 

EXIT IF Key_code=40 

END LOOP 

Key_code=0 
END IF 
i 
Go_on: ! Subroutine to turn off the softkeys 
! on the analyzer and the computer, 
! and return to main body of the 
! program. 
OFF KEY 
RETURN 
END 
! 
Lp Ga a oka dao acdc iol aa io GI SE Ra Aaa a CA IA IO a AOR 
! Iden.port: Identify io port to use. 
! Description: This routines sets up the I/0 port address for 
! the SCPI interface. For "HP 87xx" instruments, 
y the address assigned to @Hp87xx = 800 otherwise, 
! 716. 
Lise ore se occa eS SSS isaac aa i ak 1 a I ASE RoR a A 
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2410 SUB Iden_port 


2420 COM /Sys.state/ @Hp87xx,Scode, Internal 
2430 ! 

2440 IF POS(SYSTEM$ ("SYSTEM ID"),"HP 87")<>0 THEN 
2450 ASSIGN GHp87xx TO 800 

2460 Scode=& 

2470 Internal=1 

2480 ELSE 

2490 ASSIGN @Hp87xx TO 716 

2500 Scode=7 

2510 Internal=0 

2520 END IF 

2530 ! 

2540 SUBEND !tIden_port 

2550 ! 
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LOADCALS Example Program 


This program demonstrates how to read the correction arrays from the 
analyzer and write them back again. The INTeger.16 data format is being 
used because the data does not need to be interpreted, only stored and 
retrieved. More information about calibration is available in the User’s Guide. 


The size of the arrays into which the data is read is critical. If they are not 
dimensioned correctly the program will not work. Most correction arrays, 
including the factory default (DEF) and the full band (FULL, preset source 
settings) arrays have 801 points. For user defined calibrations (USER) the 
number of points must be determined. if the number of points is other than 
801, lines 1110 and 1790 will need to be changed to allocate arrays for the 
correct number of points. The number of points can be found by reading the 
correction array’s header and determining the size as shown in the example 
below. 
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1000 
1010 
1020 
1030 
1040 
1050 
1060 
1070 
1080 
1090 
1100 
1110 
1120 
1130 
1140 
1150 
1160 
1170 
1180 
1190 


1200 ! 


1210 
1220 
1230 
1240 
1250 
1260 
1270 
1280 
1290 
1300 
1310 
1320 
1330 
1340 
1350 
1360 
1370 
1380 
1390 
1400 
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!Filename: LOADCALS 


t 
! Description: 

! 4. Query the calibration arrays, based on 

s the current measurement (trans/ref1). 

i 2. Change number of points to 801. 

! 3. Download the calibration arrays back 

: into the analyzer. 

I 

DIM Func$[20] , A$[10] 

INTEGER Swap,Arrays ,Digits,Bytes ,Points 

INTEGER Corri(1:801,1:3) ,Corr2(1:801,1:3) ,Corr3(1:801,1:3) 
' 

COM /Sys_state/ @Hp87xx,Scode 

! Identify 1/0 Port 

CALL Iden_port 

1 


’ 


! Query the measurement parameter. 
OUTPUT @Hp87xx;"SENS1: FUNC?" 
' 


! Read the analyzer’s response. 
ENTER @Hp87xx; Func$ 
1 
! Set up a SELECT/CASE depending on the 
! response. 
SELECT Func$ 
1 
! This is the transmission case, a ratio of 
! the powers measured by detector 2 (B) and 
! detector 0 (R). 
CASE """XFR:POW:RAT 2, O""" 
' 
! The transmission calibration has only one 
! correction array. 
Arrays=1 


i 
! This is the reflection case, a ratio of 

! the powers measured by detector 1 (A) and 
! detector 0 (R). 

CASE """XFR:POW:RAT 1, 0""" 
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1410 
1420 
1430 
1440 
1450 
1460 
1470 
1480 


1490 ! 


1500 
1510 


1520 ! 


1530 
1540 
1550 
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1 
! The reflection calibration has 3 correction 
! arrays. 
Arrays=3 
END SELECT 
1 
! Select the 16 bit integer binary data format. 
OUTPUT @Hp87xx;"FORM:DATA INT,16" 


1 


! Select normal byte order. 

OUTPUT @Hp87xx;"FORM:BORD NORM" 

t 

! Request the first correction array from the a 
! analyzer. 

QUTPUT @Hp87xx;"TRAC? CHISCORRi" 


1560 ! 


1570 
1580 
1590 


! Turn on ASCII formatting on the I/0 path 
! to read the header information. 
ASSIGN @Hp87xx;FORMAT ON 


1600 ! 


1610 
1620 
1630 
1640 


1650 ! 
1660 ! 


1670 
1680 
1690 
1700 
1710 
1720 
1730 
1740 


! Get the header, including the number of 

! of characters that will hold the number 

! of bytes value which follows. 

ENTER @Hp87xx USING "%,A,D";A$ ,Digits 

1 

! Get the rest of the header. The number 

! of bytes to capture in the correction 

! array will be placed in "Bytes". Note 

! the use of "Digits" in the IMAGE string. 
BYTES @Hp87xx USING "4, "&£VAL$(Digits)&"D" ;Bytes 


Determine the number of points from the 
! number of bytes (6 bytes per point). 
Points=Bytes/6 


1750 ! 


1760 
1770 
1780 
1790 
1800 
1810 


! This example was set up in line 1110 above 

1 for 801 points. Edit this line and line i110 

' to allow other dimensions. 

IF Points<>801 THEN 
DISP "Arrays are not dimensioned for this calibration" 
STOP 
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1820 
1830 
1840 
1850 
1860 
1870 
1880 
1890 
1900 
1910 
1920 
1930 
1940 
1950 
1960 
1970 
1980 
1990 
2000 
2010 
2020 
2030 
2040 
2050 
2060 
2070 
2080 
2030 
2100 
2110 
2120 
2130 
2140 
2150 
2160 
2170 


2180 ! 


2190 
2200 
2210 
2220 
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END IF 


DISP “Uploading (querying) calibration arrays - 
t 


! Turn off ASCII formatting on the I/O path. 
ASSIGN @Hp87xx;FORMAT OFF 
£ 


! Get the first error correction array. 
ENTER @Hp87xx;Corri(*) 
' 


! Turn on ASCII formatting. 
ASSIGN @Hp87xx;FORMAT ON 
i 


! Get the "end of data" character. 
ENTER GHpS7xx; A$ 
i 


! For the reflection there are two more 
! arrays to read. 

IF Arrays=3 THEN 

t 


! Request and read in the second 

! correction array. 
QUTPUT @Hp87xx;"TRAC? CHISCORR2" 
Read_array (@Hp87xx,Corr2(*)) 


! Request and read in the third 
! correction array. 
OUTPUT @Hp87xx;"TRAC? CH1SCORR3" 
Read_array (@Hp87xx, Corr3(*) ) 
END IF 
DISP "Calibration arrays have been uploaded." 
WAIT 5 


DISP "Downloading (setting) calibration arrays . 


! 

! Turn off correction before writing a 
! calibration back into the analyzer. 
OUTPUT @Hp87xx;"SENS1:CORR:STAT OFF" 

1 


$ Set the number of points for the correction 
! arrays. (Not necessary in this example, 

! but shown for emphasis.) 

OUTPUT @Hp87xx;"SENS1 :SWE:POIN" ; Points 
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2230 
2240 
2250 
2260 
2270 
2280 
2290 
2300 
2310 
2320 
2330 
2340 
2350 
2360 
2370 
2380 
2320 
2400 
2410 
2420 
2430 
2440 
2450 
2460 
2470 
2480 
2490 
2500 
2510 
2520 
2530 
2540 
2550 
2560 
2570 
2580 
2590 
2600 
2610 
2620 
2630 


Example Programs 
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1 
! Prepare the analyzer to receive the first 
! correction array in the indefinite block 
! length format. 

OUTPUT @Hp87xx;"TRAC CH1ISCORRi, #0"; 

i 


! Turn off ASCII formatting. 
ASSIGN @Hp87xx;FORMAT OFF 
1 


! Send the first correction array to the 
! analyzer. The array transfer is 

! terminated with the "END" signal. 
QUTPUT @Hp87xx;Corri(*) , END 

t 


! Turn on ASCII formatting. 
ASSIGN GHp87xx;FORMAT ON 
! 


! For a reflection array download, there 
! are two more arrays. 

IF Arrays=3 THEN 

! 


! Prepare the analyzer to receive the 
! Qnd array, then output it. 
OUTPUT @Hp87xx; "TRAC CH1ISCORR2, "; 
Write_array(@Hp87xx,Corr2(*)) 


| Prepare the analyzer to receive the 
! 8rd array, then output it. 
OUTPUT @Hp87xx;"TRAC CHISCORR3, "; 
Write_array(@Hp87xx,Corr3(*)) 
END IF 
t 
{ Turn on the calibration just downloaded. 
CUIPUT GHp87xx;"SENS1:CORR:STAT ON; #WAI" 
DISP "Calibration arrays have been downloaded." 
END 
1 
! Subprogram for reading binary data array from 
! the analyzer. The command requesting a specific 
! data array has already been sent prior to 
! calling this subprogram. 
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2640 
2650 
2660 
2670 
2680 
2690 
2700 
2710 
2720 
2730 
2740 
2750 
2760 
2770 
2780 
2790 
2800 
2810 
2820 
2830 
2840 
2850 
2860 
2870 


2880 ! 


2890 
2200 
2910 


2920 ! 


2930 
2940 
2950 


1 


Example Programs 
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SUB Read_array (@Hp87xx, INTEGER Array(*)) 


DIN A$[10] 

INTEGER Digits ,Bytes 

ASSIGN @Hp87xx;FORMAT OW 

ENTER @Hp87xx USING "%,A,D";A$,Digits 

ENTER @Hp87xx USING "4, PaVAL$ (Digits) &"D" ; Bytes 
ASSIGN @Hp87xx;FORMAT OFF 

ENTER @Hp87xx; Array (*) 

ASSIGN @Hp87xx;FORMAT ON 

ENTER @Hp87xx ; A$ 


SUBEND 


t 
' 
i 
t 
i 
E 


Subprogram for writing binary data array to 

the analyzer. The command requesting a specific 
data array has already been sent prior to 
calling this subprogram. 


SUB Write_array (@Hp87xx , INTEGER Array(*)) 


OUTPUT OHp87xx; "#0"; 

ASSIGN @Hp87xx;FORMAT OFF 
OUTPUT GHp87xx; Array (*) ,END 
ASSIGN @Hp87xx;FORMAT ON 


SUBEND 


[os r a Ena GC a aa a HS Ric abv CRE ISI CR ai CR OR A RAE 


1 
1 
I 
! 
1 


Iden_port: Identify io port to use. 

Description: This routines sets up the I/O port address for 
the SCPI interface. For "HP 87xx" instruments, 
the address assigned to @Hp87xx = 800 otherwise, 
746. 


[ORG H Ered aa OR a GHA ESS GSCI IO ACI RSE AC ICAI IAEA A IK AAA AA aa 


8-58 indicates HP 8712C/14C only 
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Calibration 
2960 SUB Iden_port 
2970 CoM /Sys_state/ @Hp87xx,Scode 
2980 ! 
2990 IF POS(SYSTEM$ ("SYSTEM ID") "HP 87")<>0 THEN 
3000 ASSIGN @Hp87xx TO 800 
3010 Scode=& 
3020 ELSE 
3030 ASSIGN @Hp87xx TO 716 
3040 Scode=7 
3050 END IF 
3060 ! 
3070 SUBEND {Iden port 
3080 ! 
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CALKIT Example Program 


This instrument state file demonstrates the type of file required to download 
user-defined calibration kits. To see an example of using this feature, refer to 
“Writing or Editing Your Own Cal Kit File”, in Chapter 6 of the User’s Guide. 


10 !$ Standard Definitions for HP 85054B Precision 
Type-N Cal Kit. 

i, ot 

12 !$ This is a Cal Kit definition file, which 

13 !'$ uses the same format as a BASIC program. 

14 !$ Lines that contain “!$" are comments. 

i8 1$ 

16 !$ Put your Cal Kit file on a disk, and use the 

17 !$ analyzer’s [SAVE/RECALL] [Recall State] keys 

18 !$ to load your custom Cal Kit into the analyzer. 

20 ! 

30 !$ Definitions for 50 Ohm jack (FEMALE center 
contact) test 


40 1!$ ports, plug (MALE center contact) standards. 
so ! 

60 ! OPEN: $ HP 85054-60027 Open Circuit Plug 
7O ! ZO 50.0 $ Ohms 

go of DELAY 57.993E-12 $ Sec 

90! LOSS 0.8E+9 $ Ohms/Sec 

100 ! CO 88.308E-15 $ Farads 

110 ! Ci 1667.2E-27 $ Farads/Hz 

120 ! C2 -146.61E-36 $ Farads/Hz72 

130 ! C3. 9.7531E-45 $ Farads/Hz"3 

140 ! 

150 ! SHORT: $ HP 85054-60025 Short Circuit Plug 
160 ! ZO 50.0 $ Ohms 

170 ! DELAY 63.078E-12 $ Sec 

180 ! LOSS 8.E+8 $ Ohms/Sec 

190 ! 

200 | LOAD: § HP 00909-60011 Broadband Load Plug 
210 ! 20 50.0 $ Ohms 

220 ! DELAY 0.0 $ Sec 

230 ! LOSS 0.0 $ Ghms/Sec 


8-60 ®& indicates HP 8712C/14C only 
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Calibration 

240 ! 
250 ! THRU: $ HP 85054-60038 Plug to Plug Adapter 
260 ! ZO 50.0 $ Chms 
270 }! DELAY 196.0E-12 $ Sec 
280 }! LOSS 2.2E+9 $ Ohms/Sec 
290 } 
300 END 

@& indicates HP 8712C/14€ only 8-61 


Instrument State and Save/Recall 


LEARNSTR Using the learn string to upload and download instrument 
states. 


SAVERCL Saving and recalling instrument states, calibrations and data. 
The example also demonstrates saving data in an ASCT file 
that includes both magnitude and frequency information. 


8-62 & indicates HP 8712C/14C only 


Example Programs 
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LEARNSTR Example Program 


This program demonstrates how to upload and download instrument states 
using the learn string. The learn string is a fast and easy way to read an 
instrument state. It is read out using the *LRN? query (an ISEE 488.2 
coramon commands). To restore the learn string simply output the string to 
the analyzer. 


The learn string contains a mnemonic at the beginning that tells the analyzer 
to restore the instrument state. 


The learn string is transferred as a block. The header is ASC formatted and 
the data is in the instrument’s internal binary format. The number of bytes 
in the block of data is determined by the instrument state (no more than 
20000 bytes). 


"SYST:SET #<digits><bytes><learn string data>" 


The “long” learnstring, in addition to the instrument state like the normal 
learnstring, will include data and calibration arrays IF they are selected using 
the Define Save function under SAVE/RECALL. The SCPI equivalent command 
for saving the calibration arrays is added before the “long” learnstring query. 
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1000 
1010 
1020 
1030 
1040 
1050 
1060 
1070 
1080 
1090 
1100 
1110 
1120 
1130 
1140 
1150 
1160 
1170 
1180 
1190 
1200 
1210 
1220 
1230 
1240 
1250 
1260 
1270 
1280 
1290 
1300 
1310 
1320 
1330 
1340 
1350 
1360 
1370 
1380 
1390 
1400 
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Filename: LEARNSTR 


i 
! Description: 

i 1. Query the learn string. 

i 2. Preset the analyzer. 

} 3. Send the learn string, 

{ restoring the previous state. 
! 


DIM Learnstr$[20000] 

3 

COM /Sys_state/ @Hp87xx,Scode 
! Identify 1/0 Port 


CALL Iden_port 
1 


1 

! Request the learnstring. If the “long” 

! learnstring is desired, comment the line 

' below, and uncomment the line after it. 

! The "long" learnstring, in addition to 

! the instrument state like the normal 

! learnstring, will include data and 

! calibration arrays IF they are selected 

! using the Define Save function under 

! SAVE RECALL. The SCPI equivalent command 
! for saving the calibration arrays is 

! added before the "long" learnstring query. 
OUTPUT @Hp87xx;"*LRN?" 

QUTPUT @Hp87xx;"MMEM:STOR:STAT:CORR ON; :SYST:SET:LRNL?" 


Read the learnstring from the analyzer. 
The USING "~K" format allows the data 
being transmitted to include characters 
(such as the line feed character) that 
would otherwise terminate the learnstring 
! request prematurely. 

ENTER @Hp87xx USING "~K";Learnstr$ 

DISP "Learn string has been read" 


WAIT 5 
! 


! Preset the analyzer. 
OUTPUT @Hp87xx; "SYST :PRES ; *0PC?" 
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1410 
1420 
1430 
1440 
1450 


1460 ! 


1470 
1480 
1490 
1500 
1510 
1520 
1530 
1540 
1550 
1560 
1570 
1580 
1590 
1600 
1610 
1620 
1630 
1640 
41650 
1660 
1670 
1680 
1690 
1700 
1710 
1720 
1730 
1740 


Example Programs 
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1 
! Wait for the preset operation to complete. 
ENTER @Hp87xx ;Ope 
DISP "Instrument has been PRESET" 
WAIT 5 
t 
! Qutput the learnstring to the analyzer. 
! The mnemonic is included in the string, 
! so no command preceding "Learnstr$" is 
i necessary. 
OUTPUT @Hp87xx;Learnstr$ 
DISP “Instrument state has been restored" 
END 
1 
Dgoobsck do acid i daicaiok ci iototoioi ak cioioiok ca sei kk aoe Aka kak kk A x ak ae ok a aa 
! Iden.port: Identify io port to use. 
! Description: This routines sets up the I/0 port address for 
' the SCPI interface. For "HP 87xx" instruments, 
! the address assigned to @Hp&7xx = 800 otherwise, 
! 716. 
Dg SSS SSIS I RE ICO aI I aC aE CR a ACI ICSI REI A aC of COOK OE FA A EE Eo aa 
SUB Iden port 
COM /Sys_state/ @Hp87xx,Scode 
' 
IF POS(SYSTEM$ ("SYSTEM ID") ,"HP 87")<>0 THEN 
ASSIGN @Hp87xx TO 800 
Scode=8 
ELSE 
ASSIGN @Hp87xx TO 716 
Scode=7 
END IF 
i 


SUBEND !Iden_port 
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1000 


1010 ! 


1020 
1030 
1040 
1050 


1060 ! 


1070 
1080 
1090 
1100 


iii0 ! 


1120 
1130 
1140 
1150 
1160 
1170 
1180 
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SAVERCL Example Program 


This program demonstrates how to save instrument states, calibrations 

and data to a mass storage device. The device used in this example is the 
analyzer’s internal 3.5” disk drive. The only change needed to use this 
program with the internal non-volatile memory is to change the mass storage 
unit specifier. 


The three choices are the internal floppy disk drive (INT:), the internal 
non-volatile memory, (MEM:), and the internal volatile memory, (RAM: ). 


Lines 1110-1320 are an example of saving an instrument state and 
calibration on the interna! floppy disk drive. 


Lines 1460-1470 are an example of recalling that instrument state and 
calibration. 


Lines 1510-1560 are an exarnple of saving a data trace (magnitude and 
frequency values) to an ASCH formatted file on the internal floppy disk drive. 
This file cannot be recalled into the instrument. It can, however, be imported 
directly into spreadsheets and word processors. 


{Filename: SAVERCL 


E 

i 

COM /Sys_state/ @Hp87xx,Scode 
! Identify I/O Port 

CALL Iden_port 

! 


1 


! Select the internal floppy disk drive 
! as the mass storage device. 

QUTPUT @Hp87xx;"MMEM:MSIS ?INT:?" 

£ 


! Turn on the saving of the instrument state 
! as part of the "Define Save" function under 
! SAVE RECALL. 

OUTPUT @Hp87xx;"MMEM:STOR:STAT:IST ON" 

t 


! Turn on the saving of the calibration 
! as part of the "Define Save” function under 
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1190 
1200 
1210 
1220 
1230 
1240 
1250 
1260 
1270 
1280 
1290 
1300 
1310 
1320 
1330 


1340 ! 


1350 
1360 
1370 
1380 
1390 
1400 


1410 ! 


1420 
1430 
1440 
1450 
1460 
1470 
1480 
1490 
1500 
1510 
1520 


1530 ! 


1540 
1550 
1560 
1570 
1580 
1590 
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' SAVE RECALL. 

OUTPUT @Hp87xx;"MMEM:STOR:STAT:CORR ON" 

' 

! Turn off the saving of the data 

! as part of the “Define Save" function under 

! SAVE RECALL. 

OUTPUT GHp87xx ;"NMEM:STOR:STAT:TRAC OFF" 

i 

! Save the current defined state (STAT 1) into 

! a file named "FILTER". Use *0PC? to make 

! sure the operation is completed before any 

! other operation begins. 

OUTPUT @Hp87xx;"NMEM:STOR:STAT 1,’ FILTER’ ;*0PC?" 
ENTER @GHp87xx; Ope 

DISP "Instrument state and calibration have been saved" 
i 

! Preset the instrument so that the change in state 

! is easy to see when it is recalled. 

OUTPUT GHp87xx ;"SYST:PRES ;*0PC?" 

ENTER €Hp87xx; Ope 

DISP "Instrument has been PRESET" 

WAIT 5 

1 

! Recall the file "FILTER" from the internal 

! floppy disk drive. This becomes the new instrument 
! state. Use of the *OPC query allows hold off of 

! further commands until the analyzer is reconfigured. 
OUTPUT @Hp87xx;"MMEM:LOAD:STAT 1,’ INT: FILTER? ;xOPC?" 
ENTER GHp87xx; Ope 

i) 


! Take a single sweep to ensure that valid measurement 

! data is acquired. 

GUIPUT @HpS7xx;"ABOR;: INIT:CONT OFF; :INIT;*WAI" 

DISP “Instrument state and calibration have been recalled” 
t 

! Save that measurement data into an ASCII file. 

! called "DATAOOO1" on the internal floppy disk drive. 
OUTPUT @Hp87xx;"MMEM:STOR:TRAC CHIFDATA, > INT:DATAOO0O1?" 
DISP "Data has been saved (ASCII format)" 

END 
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1600 
1610 
1620 
1630 
1640 
1650 
1660 
1670 
1680 


1690 ! 


1700 
1710 
1720 
1730 
1740 
1750 
1760 
1770 
1780 
1730 
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lego aE oa CG ISSO Oa IG ICI a I I I a a a A aC a fk aR 
! Iden.port: Identify io port to use. 
! Description: This routines sets up the [/0 port address for 
! the SCPI interface. For "HP 87xx" instruments, 
7 the address assigned to @Hp87xx = 800 otherwise, 
| 716. 
goa aingaeoi inicio ai a ininio aR aC a SORIA KR aC I IACI I GE ak a ae 
SUB Iden port 
CoM /Sys_state/ @Hp&7xx,Scode 
! 
IF POS(SYSTEM$("SYSTEM ID") ,"HP 87")<>O THEN 
ASSIGN @Hp87xx TO 800 
Scode=8 
ELSE 
ASSIGN @Hp87xx TO 716 
Scode=7 
END IF 


SUBEND !Iiden_port 
! 


8-68 © indicates HP 8712C/14€ only 


Hardcopy Control 


PRINTPLT Using the serial and parallel ports for hardcopy output. The 
example also demonstrates plotting test results to an HPGL 
file. 


PASSCTRL Using pass control and the HP-IB for hardcopy output. The 
example uses an HP-IB printer. 


FAST_PRT Provides fast graph dumps to PCL5 printers. 
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1000 
1010 
1020 
1030 
1040 
1050 
1060 
1070 
1080 
1090 
1100 
1110 
41120 
1130 
1140 
1150 
1160 
1170 
1180 
41190 
1200 


Example Programs 
Hardcopy Control 


PRINTPLT Example Program 


This program demonstrates how to send a hardcopy to a printer on the serial 
interface. This is done by selecting the appropriate device, setting up the 
baud rate and hardware handshaking, and sending the command to print or 
plot. The *OPC? query is used in this example to indicate when the printout 
is complete. Another method of obtaining the same results is to monitor the 
Hardcopy in Progress bit (bit 9 in the Operational Status Register). More 
information on printing or plotting is available in the User’s Guide. 


Lines 1170-1400 demonstrate sending a hardcopy output to a printer 
connected to the serial port. The same program could be used to send 
hardcopy output to a device on the parallel port. The only changes would be 
deleting lines 1230-1280 and changing line 1200 to read HCOP: DEV: PORT 
PAR. 


Lines 1430-1680 demonstrate how to create an HPGL file (plotter language) 
and send it to the disk in the internal 3.5” disk drive. 


{Filename: PRINTPLT 


Description: 

Select serial port. Configure it. 
Dump table of trace values. 
Re-configure hardcopy items to dump. 
Dump HP-GL file to internal floppy. 


wm WD 


i 
1 
1 
i 
1 
1 
i 
t 


CON /Sys.state/ @Hp87xx,Scode 
! Identify I/0 Port 


CALL Iden_port 
t 


Select the output Language (PCL-Printer 
Control Language) and the hardcopy port 
to serial. 

OUTPUT @Hp&7xx;"HCOP:DEV:LANG PCL;PORT SER" 
i 


! Select baud rate to 19200. 
QUTPUT @Hp87xx;"SYST:COHM:SER:TRAN:BAUD 19200" 


8-70 & indicates HP 8712C/14€ only 


1210 
1220 
1230 


1240 ! 


1250 
1260 
1270 
1280 


1290 ! 


1300 
1310 
1320 
1330 
1340 
1350 
1360 
1370 
1380 
1390 
1400 


1410 ! 


1420 
1430 


1440 ! 


1450 
1460 


1470 ! 


1480 
1490 
1500 


i510 ! 


1520 
1530 
1540 
1550 
1560 
1570 
1580 
1590 
1600 
1610 
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i 

! Select the handshaking protocol to Xon/Xoff. 
OUTPUT @Hp87xx;"SYST:COMM:SER: TRAN: HAND XON" 
i 

! Select the type of output to table, which 

! is the same as the softkey List Trace 

! Values under the Define Hardcopy menu. 
OUTPUT @Ep87xx;"HCOP:DEV:MODE TABL" 

' 

! Send the command to start a hardcopy, and 

! use *OPC query to make sure the hardcopy is 
! complete before continuing. 

CUTPUT @Hp87xx;"HCOP ; *OPC?" 

ENTER @Hp87xx ; Opec 

DISP "Hardcopy to serial printer ~ COMPLETE!" 
1 

! Select the HPGL language and the hardcopy 

! port to be the currently selected mass memory 
! device. 

QUTPUT @Hp87xx;"HCOP:DEV:LANG HPGL;PORT MMEM“ 
t 


! Include trace data in the plot. 
QUTPUT @Hp87xx;"HCOP: ITEM: TRAC:STAT ON" 
1 


! Turn graticule off in the hardcopy dump. 
OUTPUT @Hp87xx;"HCOP:ITEM:GRAT:STAT OFF" 
i) 


! Include frequency and measurement 

! annotation. 

OUTPUT @Hp87xx;"HCOP: ITEM: ANN:STAT ON" 
1 


! Include marker symbols. 

OUTPUT @Hp87xx;"HCOP:ITEM:MARK:STAT ON" 
' 

! Include title (and/or time/date if 

1 already selected). 

QUTPUT @Hp87xx;"HCOP:ITEN:TITL:STAT ON" 
1 


! Define the hardcopy to be both the graph 
! and a marker table. 
OUTPUT @Hp87xx;"HCOP:DEV:MODE GMAR" 


& indicates HP 8712C/14C only 8-71 


1620 
1630 
1640 
1650 
1660 
1670 
1680 
1690 
1700 
1710 
1720 
1730 
1740 
1750 
1760 
1770 
1780 
1790 
1800 
1810 
1820 
1830 
1840 
1850 
1860 
1870 
1880 
1890 
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t 
! Send the command to plot and use *0PC 
! query to wait for finish. 
OUTPUT @Hp87xx ;"HCOP;*0PC?" 
ENTER @Hp87xx ;Opc 
DISP "Plot to floppy disk - COMPLETE!" 
END 
: 
Wooo Cook ak abe dni tk aoe doa i ica ok ok dia dei ki ak aloo dake acto aco aa 
! Iden_port: Identify io port to use. 
! Description: This routines sets up the 1/0 port address for 
i the SCPI interface. For "HP 87xx" instruments, 
i the address assigned to @Hp87xx = 800 otherwise, 
‘i 716. 
J iiaiiesaidioiucioisniaioisinioaisisisiciviieacickicaaol aici sass iii ak kak ak ak lak ae ack kok ea 
SUB Iden_port 
COM /Sys_state/ @Hp87xx,Scode 
i] 
IF POS(SYSTEM$ ("SYSTEM ID") ,"HP 87")<>0 THEN 
ASSIGN @Hp87xx TO 800 
Scode=8 
ELSE 
ASSIGN @Hp87xx TO 716 
Scode=7 
END IF 
t 


SUBEND !Iden_port 
' 
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1000 
1010 
1020 
1030 
1040 
1050 
1060 
1070 
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1090 
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1110 
1120 
1130 
1140 
1150 
1160 
1170 
1180 
1190 
1200 
1210 
1220 
1230 


1240 ! 


1250 
1260 
4270 


1280 ! 


1290 
1300 
1310 
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PASSCTRL Example Program 


This program demonstrates how to send a hardcopy to an HP-IB printer. 
This is done by passing active control of the bus to the analyzer so it can 
control the printer. More information about passing control to the analyzer is 


available in Chapter 3, “Passing Control.” 
!Filename: PASSCTRL 
Description: 


and then passes control to the analyzer. 
Analyzer performs hardcopy over HP-IB 


implement pass control properly. HP s700 
computers running BASIC-UX 7.0x will need 
to upgrade to a newer BASIC-UX version. 


COM /Sys_state/ ¢CHp87xx,Scode, Internal 
! Identify I/0 Port 
CALL Iden_port 


Select the language to PCL (Printer 
Control Language) and the output port 

to HP-IB. 

QUTPUT @Hp87xx;"HCOP:DEV:LANG PCL;PORT GPIB" 


! Select the HP-IB address for the hardcopy 
! device on the HP-IB. 

QUTPUT @Hp87xx;"SYST:COMM:GPIB:HCOP:ADDR 1" 
: 

! Set the output to graph only. 

OUTPUT @Hp87xx;"HCOP:DEV:MODE GRAP" 


External controller runs this program, which 
instructs the analyzer to perform a hardcopy 


to printer at 701, then passes control back. 


This program only works on controllers which 
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1320 ! If the internal controller is being used... 
1330 IF Internal=1 THEN 


1340 ! 

1350 ! then make it System Controller of HP-IB 
1360 OUTPUT @Hp87xx;"SYST:COMM:GPIB:CONT ON" 
1370 END IF 

1380 ! 


1390 ! Clear Status Registers 

1400 OUTPUT GHp87xx;"*CLS" 

1410 ! 

1420 ! Enable the Request Control bit in the Event 
1430 ! Status Register. 

1440 OUTPUT CHp87xx;"*ESE 2" 

1450 ! 

1460 ! Clear the Service Request enable register; 
1470 ! SRQ is not being used. 

1480 OUTPUT @Hp87xx;"*SRE 0” 

1490 ! 

1500 ! Send the hardcopy command to start the 
1510 ! print. 

1520 OUTPUT @Hp87xx;"HCOP" 

1530 LOOP 

1540 ! 

1550 ! Read the status byte using Serial Poll. 
1560 Stat=SPOLL(@Hp87xx) 

1570 ! 

1580 ! Exit when the analyzer requests active control 
1590 ! of HP-IB from the system controller. 
1600 EXIT IF BIT(Stat ,5)=1 

1610 END LOOP 

1620 ! 

1630 ! Now system controller passes control to 
1640 ! the analyzer. 

1650 PASS CONTROL GHpS7xx 

1660 DISP "Hardcopy in Progress..."; 

1670 IF Internal=1 THEN 

1680 ! If using the internal IBASIC controller, 
1690 ! then use the *OPC query method to wait 
1700 ! for hardcopy completion. 

1710 OUTPUT @Hp87xx;"*OPC?" 

1720 ENTER @Hp87xx ; Ope 
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ELSE 
! If external computer control, then... 
LOOP 


t 
! Monitor the HP-IB status in the 
! external computer’s HP-IB status 
! register. Here, the HP-IB interface 
! code 7 register 6 status is requested 
! and put into "Hpib". 

DISP T LS 

WAIT 1! No need to poll rapidly 

STATUS 7,6;Hpib 


When active control is returned to the 
system controller (bit 6 set), then exit. 
(This fails on s700s running BASIC 7.0x) 
EXIT IF BIT(Hpib,6)=1 
END LOOP 
END IF 
DISP "HARDCOPY COMPLETE!" 
END 


i 


Doo edbiok ack a daa aa GES RE ICRC IACI ACR ECI A HORACE A a 
! Iden_port: Identify io port to use. 

! Description: This routines sets up the I/O port address for 

! the SCPI interface. For "HP 87xx" instruments, 
i the address assigned to @CHp87xx = 800 otherwise, 
! 716. 

DE AUIS IIE ICICI AICI AIC (oF JI AA a AEA. oI A aC A ok a oC of oo 
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2020 SUB Iden_port 


2030 COM /Sys_state/ GHp87xx ,Scode, Internal 
2040 ! 

2050 IF POS(SYSTEM$ ("SYSTEM ID") ,"HP 87")<>0 THEN 
2060 ASSIGN @Hp87xx TO 800 

2070 Scode=8 

2080 Internal=1 

2080 ELSE 

2100 ASSIGN @Hp87xx TO 716 

2i1o Scode=7 

2120 Internai=0 

2130 END IF 

2140 ! 

2150 SUBEND !Iden_port 

2160 ! 
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FAST_PRT Example Program 


This program configures a PCL5 printer to accept HP-GL graphics commands 
from the analyzer. The program executes a hardcopy which causes the 
analyzer to send HP-GL commands to the parallel port PCL5 printer. Provides 
up to 10x speed improvement of some hardcopies. 


FAST_PRT 


This program is designed to set up a PCL5 printer 
connected to the parallel port of the analyzer to 
accept HP-GL syntax. HP-GL gives fast graph dumps. 


' 

{ 

i 

1 

1 

1 

! Connect your PCL5 printer to the parallel printer of the 
! analyzer, then run the program. 
i 

i 

1 

! 

t 

ij 

t 

1 

1 


Note: Firmware hardcopy support for PCL5 for 87ixCs can 
can be enabled by selecting a PCL5 harcopy device. 
This program may still be needed for the 871xBs. 


Once the parallel printer has been configured to accept 
HPGL commands, a hardcopy is done, the printer is 
reset to normal mode, and the page is ejected. 


DIM A$[50] 


COM /Sys_state/ @Hp87xx,Scode 
! Identify 1/0 Port 

CALL Iden_port 

t 


! Define the hardcopy device 
QUIPUT @Hp87xx;"HCOP:DEV:LANG HPGL;PORT CENT" 
t 


| Define PCL5 escape codes needed to set up HPGL commands: 
DATA @E ! Reset, Eject page 

DATA &@12A ! Page size 8.5 x il 

DATA &@a0L&Ca4000M@C10E ! No margins 

DATA O@*c7400x5650y 1 10.28 x 7.85 size 720/in 
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IDATA @*c5500x5650y ! if Marker table included 
IDATA @*c4255x3283y ! portrait,remove Landscape Mode 
DATA &@110 ! Landscape Mode 
DATA @*p50x50y ! Cursor to anchor point 
DATA @*cOT ! Set picture anchor point 
DATA @*r-3U ! CMY Palette 
IDATA @*r1U ! Monochrome optional 
DATA @41B ! HPGL Mode 
DATA $ ! dump plot 
DATA @%OA ! Exit HPGL Mode 
DATA @E | Eject page 
DATA DONE ! End of defined escape codes 
t 
! Send the defined escape codes to the printer 
Loop 
READ A$ 
EXIT IF A$="DONE" 
FOR I=1 TO LEN(A$) 
SELECT A$(I;1] 
CASE "@"! Escape Character 
QUTPUT GHp87xx;"DIAG:PORT:WRITE 15,0,27" 
CASE "$"! Dump the plot 
QUTPUT @HpS7xx;"HCOP ; *WAL" 
CASE ELSE! Send Character 
QUTPUT CHpS7xx;"DIAG:PORT:WRITE 15,0,";NUMCA$[I;1]) 
END SELECT 
NEXT I 
END LOOP 
t 
END 
: 
DSO I ICR AC Ra a A a a A AOR IC ACC A CA CA ACA RR CO A Co A a oo oo ab 
! Iden_port: Identify io port to use. 5 
! Description: This routines sets up the I/O port address for 
1 the SCPI interface. For "HP 87xx" instruments, 
i the address assigned to @Hp87xx = 800 otherwise, 
! 716. 
[iednioliokiek dak neck ioisiioioioi iio aiakaiok saa ii icak a a1 a a a1 aE Sk i a ea ok a aka i AK ok 
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Hardcopy Cantrel 
1660 SUB Iden_port 
1670 COM /Sys_state/ GHp87xx ,Scode 
1680 ! 
1690 IF POS(SYSTEM$("SYSTEM ID") ,"HP 87")<>0 THEN 
1700 ASSIGN @Hp87xx TO 800 
1710 Scode=8 
1720 ELSE 
1730 ASSIGN OHp87xx TO 716 
1740 Scode=7 
1750 END IF 
1760 ! 
1770 SUBEND !Iden_port 
1780 ! 
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Service Request 


SRQ Generating a service request interrupt. The example uses 
the status reporting structure to generate an interrupt as 
soon as averaging is complete. 


SRQ_INT Monitoring the status report of the analyzer. 
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SRQ Example Program 


This program demonstrates generating a service request interrupt. The SRQ 
js used to indicate when averaging is complete. More information on service 
requests and the status registers is available in Chapter 5, “Using Status 
Registers.” 


In this program, the STATus :PRESet executed in line 1250 has the effect of 
setting all bits in the averaging status transition registers (positive transitions 
to 0, negative transitions to 1). It also sets up the operational status 
transition registers (positive transitions to 1, negative transitions to 0). These 
are the states needed to generate an interrupt when averaging is complete. 


'Filename: SRQ 


i 
! Description: 

! Set an SRQ to occur when averaging is complete. 
: Turn on averaging, and set to 8 averages. 

! [Initiate sweeps. SRQ will occur after 8 sweeps. 
! Wait in a do-nothing loop, checking SRQ flag. 

! Display message after SRQ flag is set. 

1 

1 


coM /Sys.state/ @Hp87xx,Scode 
! Identify I/O Port 

CALL Iden_port 

! 


! 

! Clear status registers. 
OUTPUT @Hp87xx;"*CLS" 

! 


! Clear the Service Request Enable register. 
OUTPUT @Hp87xx;"*SRE 0” 
1 


! Clear the Standard Event Status Enable register. 
OUTPUT @Hp87xx;"*ESE 0" 
t 


! Preset the remaining status registers. 
OUTPUT @Hp87xx ;"STAT:PRES" 
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1260 ! 

1270 ! Set operation status register to report 

1280 ! to the status byte on POSITIVE transition of 
i 


1290 ! the averaging bit. 

1300 OUTPUT GHp87xx;"STAT:OPER:ENAB 256" 

1310 ! 

1320 ! Set averaging status register to report to 

1330 ! operational status register on NEGATIVE transition 
1340 ! of the averaging done bits. The NEGATIVE 


i 
1 
1 
i 
1350 ! transition needs to be detected because the 
1 
1 
i 
1 
' 


1360 ! averaging bit 0 is set to 1 while the analyzer 
1370 ! is sweeping on channel i and the number of 
1380 ! sweeps completed since averaging restart is 
1390 ! less than the averaging factor. When the bit 
1400 ! goes back to 0, the averaging is done. 


1410 GULPEE, @Hp87xx ;"STAT:OPER:AVER:ENAB 1" 

1420 

1430 Enable the operational status bit in the status 
1440 ! byte to generate an SRQ. 

1450 OUTPUT @Hp87xx;"*SRE 128" 

1460 ! 

1470 ! On an interrupt from HP-IB "Scode" (Interface 
1480 | Select Code} SRQ bit (2), branch to the interrupt 
1490 ! service routine "Srq handler". 

1500 ON INTR Scode,2 GOSUB Srq_handler 

1510 ! 

1520 ! Now enable the interrupt on SRQ (Service Request). 
1530 ENABLE INTR Scode;2 

1540 ! 

1550 | Set averaging factor to 8. 

1560 OUTPUT GHp87xx;"SENS1:AVER:COUN 8;*WAI" 

1570 ! 

1580 ! Turn on averaging and restart. 

1590 OUTPUT @Hp87xx;"SENS1:AVER ON; AVER:CLE; *Wat" 

1600 ! 

1610 ! Turn on continuous sweep trigger mode. 

1620 OUTPUT OHp87xx;"ABOR;:INIT1:CONT ON; *WAI" 

1630 ! - 

1640 ! Initialize flag indicating when averaging done 
1650 ! to O. Then loop continuously until the 

1660 ! interrupt is detected, and the interrupt 
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! service routine acknowledges the 
! interrupt and sets the flag to 1. 
Avg_done=0 
DISP “Waiting for SRQ on averaging complete."; 
LOOP 
DISP: ts 
WAIT .1! Slow down dots 
EXIT IF Avg_done=i 


END LOOP 

4 

! Display desired completion message. 
DISP 

DISP "Got SRQ. Averaging Complete!" 
STOP 

4 

Srq_handler: ! Interrupt Service Routine 
i 

! Determine that the analyzer was actually 
! the instrument that generated the 

! interrupt. 

Stb=SPOLL (@Hp87xx) 


t 

! Determine if the operation status register 
! caused the interrupt by looking at bit 7 

! of the result of the serial poll. 

If BINAND(Stb,128)<>0 THEN 


! 
! Read the operational status event register. 
OUTPUT @Hp87xx; "STAT: OPER: EVEN?" 
ENTER @Hp87xx;0p_event 
1 
! Determine if the averaging status register 
! bit 8 is set. 
IF BINAND (Op_event ,256)<>0 THEN 
! 
! If so, then set flag indicating 
| averaging done. 
Avg_done=1 
END IF 
END IF 
RETURN 
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END 
' 
Digs doce ado oar KOO a ORE Aaa II II ICICI AR I ORICA CE A I RE A A aE 
1 Iden_port: Identify io port to use. 
! Description: This routines sets up the I/0 port address for 
i the SCPI interface. For "HP 87xx" instruments, 
t the address assigned to @Hp87xx = 800 otherwise, 
iy 746. 
DG SSS ASSO A OAR ACI ORI Ra ICI ICICI (OE 1 1 I 1 A Ca A A AEE ASA A Eo of of a 2 of oo a 
SUB Iden_port 
COM /Sys_state/ @Hp87xx,Scode 
t 
IF POS(SYSTEM$("SYSTEM ID") ,"HP 87")<>0 THEN 
ASSIGN @Hp87xx TO 800 
Scode=8 
ELSE 
ASSIGN @Hp87xx TO 716 
Scode=7 
END IF 


t 


SUBEND !Iden_port 
i 
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SRQ_INT Example Program 


This program demonstrates how to monitor the status report of the network 
analyzer via an interrupt handler. It monitors all the status or error bits of 
the status register. Whenever an error or an event occurs, the analyzer will 
interrupt this program. This program will then decode the error bits and 
display the appropriate messages. For a detailed status report register map, 
refer to Chapter 5, “Using Status Registers.” : 


SRQ_INT 
BASIC program: 


1 

i 

! 

go gao Oa ado idoinik idk ieioiiicicici a deioinisie ick i lok kok eke ea ae foi eto aca 
! Description: This program implements the interrupt handler 

! routine for SRQ status reports. It tries to decode all the 

! possible error bits by rippling it through the registers 

! and print out the appropriate messages for the status report. 
! Refer to the status model diagram for registers mapping. 
1 
i 
t 
{ 
' 
! 
1 
i 


Note: To setup additional states other than the status 
model, add code to the subroutine "Setup_states”. 
Porrrerrrrerrrterrrrrrt ttt ree ete rio tert ta toe tte tt te ss oe Se tS ee 


sop Main program e+e ARE 


Make @Hp87xx common to all subroutines 
COM /Sys_state/ @Hp87xx,Scode 
! Identify the computer we are running on 
! and assign the i/o port address to @Hp87xx 
CALL Iden. port 
I 


! Setup all required SRQ registers 
CALL Setup_srq_regs 
i 


! This is required if user wants to detect either 

! "Any Ext. Keybd. Pressed" or "Front Panel Knob Turned" 
! of the Device Status Register. 

OUTPUT @Hp87xx;"SYST:KEY:QUE:STATE ON" 

i 


& indicates HP 87120/14€ only 8-85 


1300 
1310 
1320 
1330 
1340 
1350 


1360 
1370 


1380 
1390 
1400 
1410 
1420 
1430 
1440 
1450 
1460 
1470 
1480 
1490 
1500 
1810 
1520 
1530 
1540 
1550 
1560 
1870 


1680 ! 


1590 
1600 
1610 
1620 
1630 
1640 
1650 
1660 
1670 
1680 


Example Programs 
Service Request 


! Go to subroutine to setup any neccessary states 
CALL Setup_states 
i 


Report _count=0 


! Forever loop to wait for any failed events to happened 

DISP “Waiting for any Failed Events......... Report Count = 
";Report_count 

Do_loop: ! 

GOSUB Set_userbit { Read and display 
variables 

f 

GOTC Do_loop 

STOP 

1 

lekki Subroutine Blocks 3 okssp Ricks $ teak ee 

ia 

Lago aa oico aE IOI I IIE IA III AR A CaCI II AOR aE CR aE a I AC AC ICR 
! Set_userbit: Setup user bit. 

! Description: This subroutine waits for an SRQ interrupt to 

! signal that a sweep has finished. It then clears the HP-IB 

! registers by reading them. Once that is done, the user bit 

! is toggled. : 

Digogo aoc oo aaa aa GCE aI aK zGRE IRC R ACE aC I ASI IC 1 CE AE I A aK 
1 

Set_userbit: ! 

' 

ON INTR Scode GOTO Read_results { Set up interrupt branching 
ENABLE INTR Scode;2 ! Allow interrupt on SRQ 
Suspend: !WAIT 5 ! Use WAIT ’n’ to suspend IBASIC 
GOTO Suspend 

i 

! Interrupt Service Routine 

Read_results: ! Program has finished 
A=SPOLL (@Hp87xx) ! and clear the SRQ 

i] 

! This CLEAR command is for clearing out the bus just in case 

! this is a Query error. Without this CLEAR command, the previous 
! Query would screw up the state of the instrument and the next 
! Query will get an error. 

CLEAR @Hp87xx 


OUTPUT @Hp87xx;"*STB?" 
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ENTER @Hp87xx ;Stbr 
WHILE Stbr<>0 
CALL Decode_srq(Stbr) 
Stb=Stbr 
OUTPUT @Hp87xx;"*STB?" 
ENTER @Hp87xx;Stbr 
END WHILE 
OUTPUT @Hp87xx;'"*CLS" ! Clear status byte 
BEEP 
Report_count=Report_count+1 
DISP "Waiting for any Failed Events......... Report Count = 
“>Report_count 
! 
RETURN 
END 
i 
Liokkekeeekek Status Report Decode Block seseeE Hada cxe 
i 
: 
Tego mdcb i ioiicig oii dak idol iio a ogc a a aio a aC AI AR aC ASI Aa Ik ae ae oi ak a 
! Decode.srq: Decode status byte. 
! Description: Decode the Srgq register and ripple through the 
f registers and decode the necessary failed registers. 
! The decoding is done with the Event registers. The 
t corresponding Condition Registers are only read and 
! display. The numbers are display in hex numbers 
! with a leading "Ox". 
! If any Event has failed, a message will be display 
! with the “Meas” Channel number and "Segment" number. 
Diedieoo i aecnicg ia diggioii da ii icici iio dca dak aoa oI ii oka i I ek akg i i oak 
SUB Decode_srq (Reg) 
COM /Sys_state/ @Hp87xx,Scode 
DIM Reg_name$(1:8) [40] 


Print out the Date of Time of this report 


PRINT 

PRINT ’ 

PRINT "Status Report: ";DATE$(TIMEDATE);"  ";TIME$(TIMEDATE) 
PRINT 
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2090 PRINT “Status Byte = Ox"; IVAL$(Reg,16) 
2100 IF (BIT(Reg,6))=1 THEN 

2110 RESTORE 

2120 READ Reg_name$(*) 

2130 ! 

2140 ! For each of the bit set in the status register, 
2150 ! call Decode_reg() to decode the appropriate 
2160 ! second level registers. 

2170 ! 

2180 FOR I=2 TO 7 

2190 ! 

2200 IF (BIT(Reg,1)=1) THEN 

2210 CALL Decode_reg(Reg_name$(I+1)) 
2220 END IF 

2230 ! 

2240 NEXT I 

2250 ! 

2260 ELSE 

2270 PRINT "Bogus Interrupt??? Bit 6 of Status byte is not set???" 
2280 END IF 

2290 ! 

2300 PRINT 

2310 PRINT "....... END OF REPORT" 

2320 PRINT 

2330 ! 

2340 ! 

2350 ! Status Register 

2360 DATA “Unknown Register" ! Bit 0 
2370 DATA "Unknown Register" ! Bit i 
2380 DATA “Device Status" i Bit 2 
2390 DATA "Questionable" 1 Bit 3 
2400 DATA "Output Queue" ! Bit 4 
2410 © DATA "Standard Event" ! Bit 5 
2420 DATA "Status Fail" ! Bit 6 
2430 DATA “Operational” ! Bit 7 
2440 ! 

2450 SUBEND !DECODE.SRQ 

2460 ! 


2070 sna SO ORIG A FOI a IRR a a CR I a ORK a A i A a a A A OR ACR AK AC OR 
2480 ! Decode.reg: Decode the second lével registers. 
2490 ! Description: The Cases in the SELECT statements corresponds 
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! to the bits supported by the instrument. Refer 
! to the menu for the bit positions of these bits. 
! For each failed event, the Event and Condition 
! registers are read and Display. The Event register 
f is further used to decode the third level registers. 
' 
[ead Go daca i iin colo foi a a aia Ra aGI ACIS AGE Ara Ik a 8 EC 
i 
SUB Decode.reg(Reg_name$) 
COM /Sys_state/ GHp87xx,Scode 
‘ 
SELECT Reg name$ 


! Device Status register 

CASE "Device Status"! Bit 2 
QUTPUT @Hp87xx; "STAT: DEV: EVEN?" 
ENTER @Hp87xx ;Dev_event 
PRINT " Device Status Event Reg = Ox"; IVAL$(ev_event , 16) 
OUTPUT @Hp87xx;"STAT:DEV:COND?" 
ENTER @Hp87xx ;Dev.cond 
PRINT ° Device Status Condition Reg = Ox"; IVAL$(Dev_cond,16) 
CALL Decode_dev(Dev_event) 


! Questionable status register 
CASE "Questionable"! Bit 3 


OUTPUT @Hp87xx;"STAT:QUES:EVEN?"! Read and clear Questional 
STATUS reg. 

ENTER @Hp87xx ; Ques_event 

PRINT " Questionable Event Reg = Ox"; IVAL$(Ques_event, 16) 
OUTPUT @Hp87xx;"STAT: QUES: COND?" 

ENTER @Hp87xx;Ques_cond 

PRINT " Questionable Condition Reg = 0x"; IVAL$(Ques_cond, 16) 
CALL Decode_ques (Ques_event) 


CASE "Standard Event"! Bit 4 
QUTPUT @Hp87xx;"*ESR?7" 


ENTER @Hp87xx;Stand event 
PRINT " Standard Event Reg = Ox"; IVAL$(Stand_event, 16) 
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CALL Decode_esr(Stand_event) 
CASE "Output Queue"! Bit 5 


PRINT " Message Available" 


Latch bit of Status Byte register 
CASE "Status Fail"! Bit 6 
: Do Nothing 


7 Operational Status register 
CASE "Operational"! Bit 7 


OUTPUT @Hp87xx;"STAT:OPER:EVEN?"!Read and clear Operational 
STATUS reg. 

ENTER CHp87xx; Oper_event 

PRINT " Operational Event Reg = Ox"; IVAL$(Oper_event ,16) 
OUTPUT @Hp87xx;"STAT:OPER:COND?" 

ENTER @Hp87xx;Oper_cond 

PRINT " Operational Condition Reg = 0x"; IVAL$(Oper_cond, 16) 


CALL Decode_oper (Oper_event) 


CASE ELSE 
PRINT " Unsupported Bit set in Status Byte or "; 
PRINT " Bogus interrupt. " 
E 
END SELECT 


SUBEND !DECODE_REG 
! 
! 
Dogagigi aioe a iia iio aio i i io doi am Io ISI GIGI IGE III AGE AC IR Ok a aca a i ak 
! Decode.Ques: Decode Questionable Fail register. 
! Description: Decode Questionable Fail register and Print out 
i appropriate messages. 
Digg adoknilgioia iaggigkink ic aGr ao CI GIO GSK A IB AG IORI II CK aa RACK 
SUB Decode_ques (Reg) 

COM /Sys_state/ OHp87xx ,Scode 

DIM Message$(0:15,0:1) [120] 

DIM Segment.event(4:7) 


8-90 ®& indicates HP 8712C/14C only 


Example Programs 
Service Request 


READ Message$(*) 


FOR I=0 TO 15 


IF Message$(I,0)="Enable" THEN 
IF BIT(Reg,I)=1 THEN 


PRINT Message$(I,1) 
IF (I=9) THEN ! Check Limit Fail Register 


OUTPUT @Hp87xx; "STAT: QUES: LIM: EVEN?" 
ENTER @Hp87xx ;Lim_event 

PRINT " Limit Fail Event Reg = 
Ox"; IVAL$ (Lim_event , 16) 

QUIPUT @Hp87xx; "STAT: QUES:LIM: COND?" 
ENTER @Hp87xx;Lim_cond 

PRINT " Limit Fail Condition Reg = 
Ox"; IVAL$(Lim_cond, 16) 

CALL Decode_lim(Lim_event) 


END IF 


IF (I=4) OR (I=5) OR (I=6) OR (I=7) THEN 


OUTPUT @Hp87xx; "STAT: QUES:SEGM" ;VAL$(I~3) ;": EVEN?" 
ENTER @Hp87xx;Segment_event(I) 

PRINT " Segment ";VAL$(I-3);" Event Reg = 
Ox"; IVAL$(Segment_event (I) ,16) 

OUTPUT @Hp87xx; "STAT: QUES:SEGM" ; VAL$(I-3) ;": COND?" 
ENTER @Hp87xx ;Segment cond 

PRINT " Segment ";VAL$(I-3);" Condition Reg = 
Ox" ; IVAL$(Segment_cond, 16) 

CALL Decode_seg (Segment.event(I) ,I~3) 


END IF 


END IF 
END IF 
NEXT T 


This array has two fields: 

First Field - If Enable, Display the next string message 
Else, ignore the next string message. 

Second Field ~ String message for the corresponding bits of 


the Questionable register. 
DATA "Enable"," 
DATA "Enable", 


ALC UNLEVELED.......-....26- ut ! Bit 0 
FREQ_ERROR.........02+e2ee ee s! ! Bit t 


SB indicates HP 8712C/14C only 8-91 


Example Programs 
Service Request 


3670 DATA "Disable" ," 

3680 DATA "Disable" ," 

3690 DATA "Enable"," 
! Bit 4 

3700 DATA "Enable"," 
! Bit & 

3710 DATA "Enable"," 
! Bit 6 

3720 DATA "Enable"," 
! Bit 7 

3730 DATA "Disable"," 

3740 DATA "Enable"," 

3750 DATA "Enable" ," 

3760 DATA "Disable"," 

3770 DATA "Disable" ," 

3780 DATA "Disable","” 

3790 DATA "Disable"," 

3800 DATA "Disable"," 


3810 SUBEND !Decode_Ques 
3820 ! 
3830 ! 
3840 ! 


Bit 2 Unsupported” 
Bit 3 Unsupported" 


Segment 1 Limit Fail............ 
Segment 2 Limit Fail..............--- 
Segment 3 Limit Fail............ 


Segment 4 Limit Fail..........6. 


Bit 8 Unsupported" 
Limit Fadl.......sss see eens ms 
Stale Data(Data?).......... " 
Bit 11 Unsupported" 
Bit 12 Unsupported” 
Bit 13 Unsupported" 
Bit 15 Unsupported" 
Bit 15 Unsupported" 


BBS Ob aesicak akc keke ke kK AR ICG CC A a 2 a i eo a CCC ao ok aa ee a 28 ko 2k a ak ack 


iw) 


3860 ! Decode,lim: Decode Limit Fail register. 

3870 ! Description: Decode Limit Fail register and Print out the 
3880 ! appropriate messages. 

BROOD bk se seake ak akc ok oe oo ek oak ea a a oe ae a EEC CAR a RE IE a EK 2A a a 
3900 ! 

3910 SUB Decode_lim(Reg) 


3920 coM /Sys_state/ @Hp87xx,Scode 
3930 DIM Message$ (0:3) [120] 
3940 ! 

3950 READ Message$(*) 

3960 ! 

3970 FOR I=0 TO 3 

3980 IF BIT(Reg,I)#1 THEN 
3990 PRINT Message$(I) 
4000 END IF 

4010 NEXT I 

4020 ! : 

4030 ! Displaying message 


8-92 & indicates HP 8712C/14C only 


Example Programs 
Service Request 


4040 DATA " Limit Line Failed on Meas 1" ! Bit 0 
4050 DATA " Limit Line Failed on Meas 2" ! Bit di 
4060 DATA " Marker Limit Failed on Meas 1" ! Bit 2 
4076 DATA "' Marker Limit Failed on Meas 2" ! Bit 3 
4080 SUBEND !Decode_lim 

4090 ! 

4100 ! 


4410 sep cs rial soso ieiddicia dar a a I a i oi ak ki a i a2 ok aE A aC A AC I aR OE A Ea Ok ACA 
4120 ! Decode.seg: Decode Segment status registers. 

4130 ! Description: Decode Segment status registers and Print out the 
4140 ! appropriate messages. 

ALSO kkk a 2k a a 2 a A Ck A fC ACR CA ea a ok a ao oa oa aa oe ada ot kek 
4160 } 

4170 SUB Decode_seg (Reg , Segment) 


4180 COM /Sys_state/ @Hp87xx,Scode 

4190 DIM Message$(0:9) [120] | 

4200 ! 

4210 READ Message$(*) 

4220 ! 

4230 ! Check to see if bias regs need to be decoded. 

4240 FOR I=0 TO 9 

4250 IF BIT(Reg,I)=1 THEN 

4260 PRINT Message$ (I) ;Segment 

4270 IF I=4 THEN ! Meas 1 has failed? 

4280 CALL Decede_bias ("Meas 1" , Segment) 

4230 END IF 

4300 IF T+5 THEN ! Meas 2 has failed? 

4310 CALL Decode_bias("Meas 2",Segment) 

4320 END IF 

4330 END IF 

4340 NEXT I 

4350 ! 

4360 ! Displaying message 

4370 DATA " Limit Line Failed on Meas i, Segment" : 
Bit 0 

4380 DATA " Limit Line Failed on Meas 2, Segment" ! 
Bit 1 

4390 DATA " Marker Limit Failed on Meas 1, Segment" { 
Bit 2 

4400 DATA " Marker Limit Failed on Meas 2, Segment" 7 
Bit 3 


SB indicates HP 8712C/14C only 8-93 


4410 


4420 


4430 


4440 


4450 


4460 


4470 


4480 ! 
4490 ! 


4500 
4510 
4520 
4530 
4540 
4550 
4560 
4570 
4580 
45390 
4600 
4610 
4620 
4630 
4640 
4650 
4660 
4670 
4680 
4690 
4700 
4710 
4720 
4730 
4740 
4750 


Example Programs 
Service Request 


DATA " Bias Limit Failed on Meas 1, Segment" 
baa Bias Limit Failed on Meas 2, Segment" 
DATA Gain Bar Limit Failed on Meas 1, Segment’ 
re Gain Bar Limit Failed on Meas 2, Segment" 
pene Tic Ack Test Failed on Meas 1, Segment" 
ae IIc Ack Test Failed on Meas 2, Segment" 
Bit 9 


SUBEND !Decode.seg 
t 


t 

DGS AAG CO OBO Fa IOC JCI 2 Gk So FI a i ai a2 ae 
! Decode_dev: Decode Device status register. 

! Description: Decode Device status register and Print out the 
4 appropriate messages. 

Tigglo ado Rid oR aa boh an arab Ba oa ERE sok a ia i i ak aie ae ea 
3} 

SUB Decode_dev (Reg) 

COM /Sys_state/ C@Hp87xx,Scode 

DIM Message$(0:3) [120] 


READ Message$(*) 
FOR I=0 TO 3 
IF BIT(Reg,I)=1 THEN 
PRINT Message$ (I) 


END IF 
NEXT I 
1 
DATA " Any Key Pressed’ 
DATA " Any Softkey Pressed" 
DATA " Any Ext. Keybd. Pressed" 
DATA " Front Panel Knob Turned” 


SUBEND !Decode dev_ 
' 


8-94 & indicates HP 8712C/14C only 


4760 
A770 
4780 


4730 } 


4800 
4810 
4820 
4830 
4840 
4850 
4860 
4870 
4880 
4890 
4900 
4910 
4920 
4930 
4940 
4950 
49360 
4970 
4980 
4990 
5000 
5010 
5020 
5030 
5040 


5060 
5070 
5080 
5030 
5100 
5110 
5120 
5130 
5140 
5150 
5160 


Example Programs 
Service Request 


Dig ggo aa a GRACIA ISG AG Ia AEC Ia A aOR AAR K a a i a 
! Decode_esr: Decode Standard Event register 
! Description: Decode Standard Event register and Print out the 


appropriate messages 


Be sk ogee oe ke oR Seok a Ea ak i aE a ok 2 a i oe oie a 2c a i ai 2k a i ok oo ak oa ai a a ak oa of of a ai aie a 


SUB Decode_esr (Reg) 
coM /Sys_state/ @Hp87xx,Scode 
DIM Message$ (0:7) [120] 


READ Message$ (x) 
FOR I=0 TO 7 
IF BIT(Reg,I)=1 THEN 


PRINT Message$(I) 


IF I=4 THEN 
CALL Disp_err 
END IF 
END IF 
NEXT I 
t 

DATA " Operation Complete" 
DATA " Request Control" 
DATA " Qeury Error" 
DATA " Device-Dependent Error" 
DATA " Execution Error" 
DATA " Command Error" 
DATA * User Request” 
DATA " Power On" 


SUBEND !Decode_esr 
5050 ! 


Bit 
Bit 
Bit 
Bit 
Bit 
Bit 
Bit 
Bit 


NOOO PWN HO 


1 oe oho eo a OA a oi OOK Ao a a oR CC ae fe fe oe a oe eo oe ef 9 ae eae ke eae oe ae a eae a oe a ak 
! Decode_oper: Decode Operational register. 


! Description: Decode Operational register and Print out the 
! appropriate messages 
DSS IGG GAG ISOC CIC ACI IOI a. AR a 136 1 9 a I ACR AC ACC A A EE CaS a 


SUB Decode_oper(Reg) 
com /Sys_state/ @Hp87xx,Scode 
DIM Message$(0:15,0:1) [120] 


& indicates HP 87120/14€ only 


8-95 


8170 
5180 
5190 
5200 
5210 
5220 
§230 
5240 
5250 
5260 
5270 


5280 
$290 
5300 


§310 
5320 
5330 
5340 
5350 
5360 
5370 
§380 


5390 
5400 
5410 


5420 
5430 
5440 
5450 
5460 
5470 
5480 
5490 
5500 
5510 
5520 
5530 


Example Programs 
Service Request 


READ Message$ (*) 
FOR I=0 TO 15 
IF Message$(1,0)="Enable" THEN 
IF BIT(Reg,I)=1 THEN 


PRINT Message$(I,1) 
IF I=4 THEN 


OUTPUT @Hp87xx; "STAT: OPER:MEAS: EVEN?" 
ENTER GHp87xx;Meas event 

PRINT "Measuring Event Reg 

Ox"; IVAL$ (Meas_event , 16) 

OUTPUT @Hp87xx;"STAT: OPER:MEAS:COND?" 
ENTER @Hp87xx;Meas_cond 

PRINT "Measuring Condition Reg 

Ox" ; IVAL$ (Meas_cond, 16) 


CALL Decode_meas(Meas_event) 
ELSE 
IF I=8 THEN 


OUTPUT @HpS7xx; "STAT: OPER: AVER: EVEN?" 
ENTER @Hp87xx;Aver_event 

PRINT "Averaging Event Reg 

Ox"; IVAL$(Aver_event , 16) 

OUTPUT @Hp87xx; "STAT: 0PER:AVER: COND?" 
ENTER @Hp87xx;Aver_cond 

PRINT "Averaging Condition Reg 

Ox" ; IVAL$(Aver_cond, 16) 


CALL Decode_avg(Aver_event) 
END IF 
END IF 


END IF 
END IF 
NEXT I 


This array has two fields: 
First Field - If Enable, Display the next string message 
Else, ignore the next string message. 


8-96 &$ indicates HP 87120/14€ only 


5540 
5550 
5560 
5570 
5580 
5590 
5600 
5610 
5620 
5630 
5640 
S650 
5660 
5670 
5680 
5690 
5700 
5710 
8720 


5730 ! 


5740 
5750 
5760 
5770 
5780 
5790 
5800 
5810 
5820 
5830 
5840 
5850 
5860 
5870 
5880 
5890 
5900 
5910 
5920 
5930 
5940 


Example Programs 
Service Request 


Second Field - String message for the corresponding bits of 
the Questionable register. 
DATA "Enable"," Calibrating............4.. ! Bit 0 
DATA “Enable"," Settling.............--.-. a 1 Bit t 
DATA "Disabie"," Bit 2 Unsupported" 1 Bit 2 
DATA "Disable" ," Bit 3 Unsupported” ! Bit 3 
DATA "Enable"," Measuring. ........+++-e.e0: 7 ! Bit 4 
DATA "Disable" ," Bit 5 Unsupported" ! Bit 5 
DATA "Disable" ," Bit 6 Unsupported" ! Bit 6 
DATA "Enable"," CORTECTANE. cite te ate Re daw’ y ! Bit 7 
DATA "Enable"," Averaging. ......------+-- w 1 Bit 8 
DATA "Enable"," Hardcopy In Progress...... us 1 Bit 9 
DATA "Enable"," Service Test In Progress..." ! Bit 10 
DATA "Disable" ," Bit 11 Unsupported" 1 Bit it 
DATA "Disable" ," Bit 12 Unsupported" 1 Bit 12 
DATA "Disable"," Bit 13 Unsupported” ! Bit 13 
DATA "Enable"," Program Running........... M ! Bit 14 
DATA "Disable" ," Bit 15 Unsupported" 1! Bit 15 
SUBEND !Decode_oper 
DSS SR a HE Ho a iia ido idk aaa acis a rok ak Aik A a koa a a ak i dc kok ok 
! Decode.meas: Decode Measuring register. 
! Description: Decode Measuring register and Print out the 
appropriate messages. 
Diggaa oes daci ia doi i cio ici gi GOI OI IGS aE CaRACE ICRI ICA A EAC ACR KA IA 
SUB Decode.meas (Reg) 
COM /Sys.state/ @Hp87xx,Scode 
DIM Message$(0:1) [120] 
READ Message$(*) 
FOR T=0 TO 1 
IF BIT(Reg,I)=1 THEN 
PRINT Message$(I) 
END IF 
NEXT I 
Displaying message 
DATA " Meas 1 Measuring......... " 
DATA " Meas 2 Measuring......... H 
& indicates HP 87120/14€ only 8-97 


5950 
5960 


5970 ! 


5980 
5990 
6000 
6010 
6020 
6030 
6040 
6050 
6060 
6070 
6080 
6090 
6100 
6110 
6120 
6130 
6140 
6150 
6160 
6170 
6180 


6190 ! 
6200 ! 


6210 
6220 
6230 
6240 
6250 
6260 
6270 
6280 
6290 
6300 
6310 
6320 
6330 
6340 
6350 


Example Programs 
Service Request 


SUBEND !Decode_meas 
1 
\ 
Le io a adialoia dala tea aca sii i i a aa iofoke sic feic eg ci ok si I RR Aa AR aR ACA SCC AEE A A 
! Decode_avg: Decode Averaging registe. 
! Description: Decode Averaging register and Print out the 
t appropriate messages. 
De ICO ICICI IISA a ICICI ICR ARCA AACA AC CCA AK Ak A Ao EE Co EE oe oe eae i a 
iT 
SUB Decode_avg(Reg) 
COM /Sys_state/ @Hp87xx ,Scode 
DIN Message$(O:1) [120] 


READ Message$(*) 
FOR f=0 TO 1 
IF BIT(Reg,I)=1 THEN 
PRINT Message$(I) 


END IF 
NEXT I 
! 
! Displaying message 
DATA " Meas 1 Averaging......... ‘a 
DATA " Meas 2 Averaging......... rf 


SUBEND !Decode_avg 
' 


' 

[gio sO SIO I ROK ES a cok ak oie a ie kk ak ak ai ok A a ek ORE a A a a oo a EI 
! Decode_bias: Decode Blas register. 

{ Description: Decode Bias register and Print out the 

. appropriate messages. 

1 2 ROR 2 CAR RE OC RE 2A FCO AE FO 2 AC a aa of oe a ae a ak of a oo ea aE 
t 

SUB Decode_bias(Meas$ ,Segment) 

COM /Sys_state/ @Hp87xx ,Scode 

DIM Message$(0:11) [120] 


READ Message$ (*) 
SELECT Meas$ 


CASE "Meas 1" 
Chan=1 
CASE “Meas 2" 


8-98 ; indicates HP 8712C/14C only 


6360 
6370 
6380 


6390 
6400 
6410 
6420 
6430 
6440 
6450 
6460 
6470 
6480 
6490 
6500 
6510 
6520 
6530 
6540 
6550 
6560 
6570 
6580 
6590 
6600 
6610 
6620 
6630 
6640 
6650 
6660 
6670 
6680 
6690 
6700 
6710 
6720 
6730 
6740 
8750 


Chan=2 
END SELECT 
OUTPUT 
@Hp87xx; "CALC"; VAL$(Chan) ;":BIAS:LIM:SEGM" ; VAL$ (Segment) ;":COND?" 
ENTER @Hp87xx ; Node 
FOR I=0 TO 11 
IF BIT(Node,I)=1 THEN 

PRINT Message$(I);" of ";Meas$;", Segment "; VAL$ (Segment) 
END IF 


NEXT 


4 Displ 


DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 


I 


aying message 
4 


SUBEND !Decode_bias 


! 
' 


SUB Disp. 


err 


Current 
Current 
Current 
Current 
Current 
Current 
Current 
Current 
Current 
Current 
Voltage 
Voltage 


Limit 
Limit 
Limit 
Limit 
Limit 
Limit 
Limit 
Limit 
Limit 
Limit 
Limit 
Limit 


COM /Sys_state/ @Hp87xx,Scode 


DIN Errmsg$ [400] 
INTEGER Errnum 


LOOP 


QUIPUT GHp87xx;"SYST:ERR?" 


Failed 
Failed 
Failed 
Failed 
Failed 
Failed 
Failed 
Failed 
Failed 
Failed 
Failed 
Failed 


ENTER @Hp87xx;Errnum,Errmsg$ 


EXIT 


IF Errnum=0 


PRINT " 
END LOOP 


" sErrnum;Errmsg$ 


on 
on 
on 
on 
on 
on 
on 
on 
on 
on 
on, 
on 


Bias 
Bias 
Bias 
Bias 
Bias 
Bias 
Bias 
Bias 


4" 
Q" 
gu 
4" 
5" 
6! 
7 
gu 


VTune " 
VTotal" 
VAuxi ' 
VAux2 ' 


Examole Programs 
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& indicates HP 8712C/14€ only 


8-99 


Example Programs 
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6760 SUBEND ! Disp_err 

6770 ! 

6780 ! 

6790 Bakaiacsiginciokkioblicni io sonia a dag acdc c a a IRGC IC ICI ICICI HC CK a 
6800 ! Iden_port: Identify io port to use. 

68.10 esos daddodio oe ia a iio ac aaj IRI IA AO ACR aR A RSE AR AACE KE HK 
6820 SUB Iden_port 


6830 COM /Sys.state/ @Hp87xx ,Scode 
6840 ! 

6850 IF POS(SYSTEM$("SYSTEN ID") ,"HP 87")<>0 THEN 
6860 ASSIGN @Hp87xx TO 800 
6870 Scode=8 

6880 ELSE 

6890 ASSIGN @Hp87xx TO 716 
6300 Scode=7 

6910 END IF 

6920 ! 

6930 SUBEND ! Iden_port 

6940 ! 


BOSO beck ook ok a A AES A RR CARR DRC AR CC oo i of RO 2k i Co iE a oe oi ao ko a a i aac 
6960 ! Setup states: 

6970 | Note: Insert any setup routines or statements in here..... 
6980 ! This routine is execute before interrupt is enabled. 
GEOSO Fo ak ek aha oe ae af i ae a cok a aK kc ak oe aes ak ca ai ok sk a a ke aa i ie ea CS OR A ok aC oe a i ae a a 
7000 ! 

7010 SUB Setup_states 

7020 ! 

7030 ! 

7040 SUBEND !Setup_states 

7050 ! 

7060 ! 

TZ OTZ OVA AK OR a RR RE CR A RC KE RE A AO CC TE EE CEE OE I A 
7080 ! Setup_srq.regs: Set up SRQ interrupt registers. 

TO90 be oR aOR aR dk aR A OR So Sk aR a ee a SE aa a a a ae 


7100 SUB Setup.srq_regs 


7110 COM /Sys_state/ @Hp87xx,Scode 

7120 ! 

7130 | Initialize interrupt registers 

7140 ! 

7150 OUTPUT @Hp87xx;"*CLS" ! Clear the STATUS BYTE 
register 


8-100 6S indicates HP 8712C/14C only 


7160 


T7170 


7180 
7190 ! 
7200 
7210 ! 
7220 
7230 


7240 
7250 
7260 
7270 


7280 
7290 


7300 
7310 


7320 
7330 


7340 
7350 
7360 ! 
7370 ! 
7380 


7390 
7400 


7410 
7420 } 


OUTPUT GHp87xx;"*SRE 0" 
enable register 

OUTPUT @Hp87xx;"*ESE 0" 
register 


OUTPUT @Hp87xx;"STAT: PRES" 


OUTPUT @Hp87xx; "STAT: QUES 
OUTPUT @Hp87xx;"STAT: QUES 
Register 


QUTPUT @Hp87xx;"STAT: OPER: 
OUTPUT @Hp87xx;"STAT: OPER: 
:SEGM1: 


OUTPUT @Hp87xx;"STAT: QUES 


QUTPUT @Hp87xx;"STAT: QUES: 


Register 
OUTPUT @Hp87xx;"STAT: QUES 


OUTPUT @Hp87xx;"STAT: QUES: 


Register 


OUTPUT @Hp87xx;"STAT: QUES: 
:SEGM3 


OUTPUT @Hp87xx;"STAT:QUES 
Register 
OUTPUT @Hp87xx;"STAT: QUES 
OUTPUT @Hp87xx ; "STAT: QUES 
Register 


:PTR #HO6F3" 
:ENAB #HOGF3"! Enable Questionable 


:SEGM2: 


:SEGM4: 
7SEGM4: 


Example Pragrams 
Service Request 


$ Clear the service request 
! Clear the std event enable 


! Clears all other registers 


! Set up registers for interrupt on Measuring going false 


! Positive Transition 


PTR #HFFFF" ! Positive Transition 

ENAB #HO600"! Enable Operational Register 
PTR #HO3FF"! Positive Transition 
SEGM1:ENAB #HO3FF"! Enable Segment 1 
PTR #HO3FF"! Positive Transition 
SEGM2:ENAB #HO3FF"! Enable Segment 2 
:PTR #HO3FF"! Positive Transition 
:ENAB #HOS3FF"! Enable Segment 3 


SEGN3 


PTR #HO3FF"! Positive Transition 
ENAB #HO3FF"! Enable Segment 4 


OUTPUT GHp87xx;"STAT:DEV:PTR #HFF" 
OUTPUT @HpS7xx;"STAT:DEV:ENAB #HFF" 


OUTPUT @Hp87xx;"*CLS" 
register 


OUTPUT @Hp87xx;"*SRE #HFF" 
OUTPUT @Hp87xx;"*ESE #HFF" 


registers 


! Clear the STATUS BYTE 


! Allow SRQ on all Registers 
! Enable standard event 


OUTPUT @HpS7xx;"*PSC #HFFFF" 


7430 SUBEND ! Setup_srq_regs 


S indicates HP 8712€/14€ only 8-101 


File Transfer Over HP-IB 


Two example programs demonstrate how to transfer files from the analyzer’s 
mass memory to and from mass memory of an external controller via HP-IB. 
Instrument states and program files may be transferred to or from the 
analyzers internal non-volatile memory, (MEM:), internal-volatile memory, 
(RAM:), and the internal 3.5” floppy disk, (INT:). 


This can be a convenient method to archive data and programs to a central 
large mass storage hard drive. 


To run these programs, connect an external controller to the analyzer with an 
HP-IB cable. 


GETFILE Transfers a file from the analyzer to an external controller. 
PUTFILE Transfers a file from an external controller to the analyzer. 


8-102 & indicates HP 8712C/14C only 


1000 
1010 
1020 


1030 


1040 
1050 


1060 ! 


1070 
1080 
1090 
1100 
1110 
1120 
1130 
1140 
1150 
1160 
1170 
1180 
1190 
1200 
1210 
1220 
1230 
1240 
1250 
1260 


Example Programs 
File Transfer Over HP-4B 


GETFILE Example Program 


Files are transferred from the analyzer to an external RMB controller. Run 
this program on your external RMB controller. The program will prompt you 
to specify which analyzer program to transfer, the mass storage unit (MEM:), 
internal non-volatile memory, (RAM:), internal volatile memory, or (INT:), 
internal 3.5” floppy disk drive and the name of the file to be created on your 
external controller mass storage. Transfers instrument state files or program 
files. 


IGETFILE 

! 

! This program will get files from 871X specified mass storage to a 
host 

! mass storage. The user specifies the mass storage unit, the 
filename 

! of the 871X and the file on the host controller to be created. 


1 

DIM B1k$(1:10)[32000] ! Max file size = 10 * 32000 = 320000 bytes 
i 

DIM Filename$[15],Mass$[15] ,Dest$[15] 

INTEGER Wordi 

! 

COM /Sys_state/ CHp87xx,Scode 

! Identify 1/0 Port 

CALL Iden_port 

1 

BEEP 

Mass$="INT" 

Dest$="File871X" 

INPUT “Enter the name of the 871X file to get.",Filename$ 
INPUT "Enter 871X Mass Storage (mem, INT,ram)" ,Mass$ 
INPUT "Enter host filename (default=’File871X’)" ,Dest$ 
DISP "READING FILE "&Mass$k":"@Filename$&" ..." 

OUTPUT @Hp87xx;"MMEM: TRANSFER? ’"&Hass$g":"&Filename$z"’" 
ENTER @Hp87xx USING "#,W";Word1 

ENTER @Hp87xx USING "%,~K";Bl1k$(*) 

FOR I=1 TO 6 
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1270 Filelength=LEN(B1k$(I))+Filelength 

1280 NEXT I 

1290 BEEP 

1300 PRINT "Length" ,Filelength 

1310 DISP "Creating new file..." 

1320 ON ERROR GOTO Save_file 

1330 PURGE Dest$ 

1340 Save_file: : 

1350 OFF ERROR 

1360 CREATE Dest$,Filelength 

1370 ASSIGN @File TO Dest$;FORMAT ON 

1380 OUTPUT @File;B1K$(*) ; 

1390 ASSIGN @File TO * 

1400 DISP "File "&Dest$&" created." 

1410 BEEP 

1420 END 

1430 ! 

444.0 aap de Gd oid oidagaaRio ioiok tok ictokak cia i iad ick fear asi k ae foie loki dea dok a tok 
1450 ! Iden_port: Identify io port to use. 

1460 | Description: This routines sets up the 1/0 port address for 


1470 ! the SCPI interface. For "HP 87xx" instruments, 
1480 ! the address assigned to @Hp87xx = 800 otherwise, 
1490 ! 716. 


4500 Gebagdaia a aok kia io jiomioi ai sali ae ick 30 ai a a 1 A A aE A A oi 
1510 SUB Iden_port 
1820 COM /Sys_state/ @Hp87xx,Scode 


1530 ! 

1840 IF POS(SYSTEM$ ("SYSTEM ID") ,"HP 87")<>O THEN 

1550 ASSIGN @Hp87xx TO 800 

1560 Scode=8 

1570 ELSE 

1880 ASSIGN @Hp87xx TO 716 

1590 Scode=7 

1600 END IF : 
1610 | : 
1620 SUBEND !Iden_port 

1630 ! i 
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PUTFILE Example Program 


PUTFILE - Files are transferred from the RMB mass storage to the analyzer. 
Run this program on your external RMB controller. The program will prompt 
you to specify the file to transfer and where to transfer the file. BDATA or 
ASCI files ray be transferred to the analyzer’s internal non-volatile memory, 
(MEM:), the internal volatile memory, (RAM:), or the internal built in 3.5” 
floppy disk, (INT:). 


PUTFILE 


J 
: 
! This program will transfer files from RMB mass mem to the specified 
! 871X mass storage. The user specifies the 871% mass storage unit, 
t the 871K file to be created, file type, and file to be transferred. 
1 


1 

DIM A$(1:4) [32000] 

DIM Filename$ [15] ,Mass$[15] ,Source$[15] 
INTEGER Word4 

t 

COM /Sys_state/ @Hp87xx ,Scode 

1 Identify I/O Port 

CALL Iden_port 

' 


Bdat$="n" 

BEEP 

Mass$="INT? 

INPUT “Enter the name of the 871X file to create" ,Filename$ 
INPUT "File type BDAT? (y,n) [n]",Bdat$ 

INPUT "Enter the 871X Mass Storage (mem, INT,ram)" ,Mass$ 
INPUT "Enter source filename" ,Source$ 

DISP "READING FILE "gSource$a" ..." 

ASSIGN @File TO Source$;FORMAT OFF 

ENTER @File USING "%,-K";A$(*) 

ASSIGN @File TO * 

!PRINT A$ 

BEEP 

Length=0 

FOR I=1 TO 4 
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1300 Length=LEN (A$ (I))+Length 

1310 NEXT I 

1320 DISP "TRANSFERRING FILE = ",Length 
1330 IF Bdat$="y" OR Bdat$="Y" THEN 


1340 IF Length<i0 THEN 

1350 BLK$=" 1" ZVAL$ (Length) 

1360 ELSE 

1370 IF Length<100 THEN 

1380 BLES="2"&VAL$ (Length) 

1390 ELSE 

1400 IF Length<1000 THEN 

1410 BLK$="3"£VAL$ (Length) 
1420 ELSE 

1430 IF Length<10000 THEN 

1440 Blk$="4"&VAL$ (Length) 
1450 ELSE 

1460 IF Length<100000 THEN 
1470 Blk$="5"£VAL$ (Length) 
1480 ELSE 

1490 Blk$="6"&VAL$ (Length) 
1500 END IF 

1510 END IF 

1520 END IF 

1530 END IF 

1540 END IF 


1550 OUTPUT ¢HpS7xx; “MMEM: TRANSFER: BDAT 
1 UgMass$&" :"&Filename$e"? ,#°RB1kS; 
1560 ELSE 
1570 OUTPUT @Hp87xx; "MMEN: TRANSFER > "eMass$&":"eFilename$&"? ,#0"; 
1580 END IF 
1590 OUTPUT @Hp87xx;A$(*) ;END 
1600 DISP "871X file "&Mass$x":"&Filename$&" created." 
1610 BEEP 
1620 END 
1630 ! 
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Dino ed a oa a GIA G I IC ICI a I I I a I ICI ICI FCI FEE a AOI ROR I aD ACC oR a ok a ak 
! Iden_port: Identify io port to use. 
! Description: This routines sets up the I/0 port address for 
! the SCPI interface. For "HP 87xx" instruments, 
! the address assigned to GHp87xx = 800 otherwise, 
H 716. 
Dd Go a Se a AGS aORIG CSIR CIRC AIG ICK AKI AIK A i a ak fa 
SUB Iden_port 
COM /Sys._state/ @Hp87xx,Scode 
ft 
IF POS(SYSTEM$ ("SYSTEM ID"), "HP 87")<>0 THEN 
ASSIGN @Hp87xx TO 800 
Scode=8 
ELSE 
ASSIGN @Hp87xx TO 716 
Scode=7 
END IF 


SUBEND !Iden_port 
i 
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GRAPHICS Using graphics and softkeys to create customized procedures. 
The example demonstrates the use of some of the user 
graphics commands including the one to erase a previously 
drawn line. It also demonstrates use of the softkeys and 
detecting a front panel keypress with the service request 
interrupt process. 


GRAPH2 Using graphics to draw an instrument and DUT onto the 
display. 
GETPLOT Reading an HPGL graphics file. 
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GRAPHICS Example Program 


This program demonstrates how to use the analyzer’s user graphics 
commands to draw setup diagrams. It also demonstrates generating a service 
request in response to a keyboard interrupt. More information on user 
graphics commands is available in Chapter 7, “Using Graphics,” and in 
Chapter 12, “SCPI Command Summary”. Information on generating a service 
request and using the status reporting structure is in Chapter 5, “Using Status 
Registers.” 


Note that this program uses the analyzer’s user graphics commands. If 
the IBASIC option is installed, graphics may sometimes be more easily 
implemented using BASIC commands such as POLYGON and RECTANGLE. 
For further information, see the “BARCODE” program description in the 
HP Instrument BASIC Users Handbook. 


Lines 170-240 draw and label a representation of an HP 8711 for a 
connection diagram. This example is a simple front view from the top. 


Lines 250-450 draw the connection needed for a normalization. The 
operator is prompted to make this connection and to press a softkey on the 
instrument. A flashing message is used to attract attention. 


NOTE 


This program works properly on/y when Option 1C2, IBASIC, has been installed. Refer to program 
GRAPH? if your analyzer does net have the IBASIC option installed. 
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' 
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| 
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GRAPHICS example connection diagram 


Lines 460-580 perform the normalization, erase the prompts (without erasing 
the whole screen) and prepare for the test. 


Lines 590-730 are a branching routine that handles the service request 
generated interrupts used by the external controller. 


COONAN AWNHE 


f 
t 
t 
i 
1 
1 
! 
t 
f 


Filename: GRAPHICS 


Description: Draws a simple connection diagram 
in the IBASIC window, and displays a softkey. 


NOTE: This program works properly ONLY 
when option 1€2, IBASIC, has been installed. 
Refer to program GRAPH2 if no IBASIC option. 
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IF POS(SYSTEN$("SYSTEM ID") ,"HP 871") THEN 
ASSIGN @Hp8711 TO 800 
Internal=1 
Isc=8 
ELSE 
ASSIGN @Hp8711 TO 716 
Internal=0 
Isc=7 
ABORT 7 
CLEAR 716 
END IF 
t 
! Allocate an IBASIC display partition 
! to show the graphics. 
OUTPUT @Hp8711;"DISP:PROG UPP" 
1 


! Clear the IBASIC display partition. 
OUTPUT GHp8711;"DISP:WIND10:GRAP:CLE" 
i 


! Turn on channel 2 for measurements. The 
! lower part of the display is 

! devoted to display of measurements. 
OUTPUT @Hp8711;"SENS2:STAT ON;*WAI" 

t 


! Take a single controlled sweep to ensure 

! a valid measurement using *OPC query. 

OUTPUT GHp8711;"ABOR; :INIT2:CONT OFF; :INIT2;*0PC?" 
ENTER @Hp8711;Ope 

1 


! Select the bright "pen" and bold font. 
OUTPUT @Hp8711;"DISP:WIND10:GRAP:COL 1;LAB:FONT BOLD" 


E 
! Draw a Label reading "HP 8711C" at 45 pixels 
! to the right and 120 pixels above the origin. 
! The origin is the lower left corner of the 

! current graphics window (upper half). 

OUTPUT @Hp8711;"DISP:WIND10:GRAP:MOVE 45,120 
;LAB °HP 8711¢c7" 

£ 

! Draw a box to represent the analyzer. 

OUTPUT @Hp8711;"DISP:WIND10:GRAP:MOVE 30,175 
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;DRAW 30,140;DRAW 480,140;DRAW 480,175" 


194 ! 
192 } Draw a box to represent the REFLECTION RF OUT port. 
200 OUTPUT @Hp8711;"DISP:WIND10:GRAP:MOVE 275,140 

;DRAW 275,130;DRAW 305,130;DRAW 305,140" 

201 ! Draw a box to represent the TRANSMISSION RF IN port. 
210 OUTPUT @Hp8711;"DISP:WIND1O:GRAP:MOVE 410,140 
;DRAW 410,130;DRAW 440,130;DRAW 440,140" 
2it ! Change the text font to small, which is the 

212 $ same as that used for PRINT or DISP statements. 

220 OUTPUT GHp8711;"DISP:WIND1O:GRAP:LAB:FONT SMAL" 

221! 

222 ! Label the RF OUT port. : 

230 OUTPUT @Hp8711;"DISP:WIND10:GRAP:MOVE 250,145 
;LAB ’RF 0UT’" 

231. 3 

232 ! Label the RF IN port. 

240 OUTPUT @Hp8711;"DISP:WIND1O:GRAP:MOVE 395,145 
;LAB ’?RF IN’” 

241! 

250 Normalize: ! 

251! 

252 |! Draw a through connection between the RF OUT 

253 ! and RF IN ports. 

260 OUTPUT @Hp8711;"DISP:WIND10:GRAP:MOVE 290,125 
;DRAW 290,110;DRAW 425,110;DRAW 425,125" 

261 ! Prompt the operator to connect the through. 

270 OUTPUT @Hp8711;"DISP:WIND1O:GRAP:MOVE 1,50 
;LAB °?Connect THRU between RF OUT anc RF IN’" 

280 IF Internal=1 THEN 

281 ! If using the IBASIC (internal) controller, 

282 ! then use the "ON KEY" method to handle 

283 ! user interface. 

290 ON KEY 1 LABEL "NORMALIZE" RECOVER Norm 

300 ELSE 

301 ! If using an external controller... 

302 1 

303 ! Initialize flag for checking on keyboard 

304 ! interrupts. 

310 Keycade=-i 

311 t 
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! Label softkey 1. 
OUTPUT @Hp8711;"DISP:MENU:KEY1 *NORMALIZE?* 
1 


! Clear the status register and event status 
! register. 

OUTPUT @Hp8711;"*CLS;*ESE 0" 

1 

! Preset the other status registers. 

! Enable the Device Status register to report 
! to the Status Byte on positive transition 
! of bit O (key press). Enable the Status 

! Byte to generate an interrupt when the 

! Device Status register’s summary bit 

! changes. 

OUTPUT GHp8711;"STAT:PRES;DEV:ENAB 1;*SRE 4" 
t 


! Clear the key queue to ensure that previous 
i key presses do not generate an interrupt. 
OUTPUT @Hp8711; "SYST: KEY :QUE:CLE" 

1 


! Set up and enable the interrupt on the HP~IB 
! when a service request is received. 

ON INTR Isc,5 RECOVER Srq 

ENABLE INTR Isc;2 


END IF 


Turn off the graphics buffer. 


QUIPUT GHp8711;"DISP:WIND1O:GRAP:BUFF OFF" 


Loop for waiting for press of the NORMALIZE key. 
The two different output statements along with 
the wait statements create a blinking effect. 
There is not exit from this loop other than 

a keyboard interrupt. 


Loop 


OUTPUT @Hp8711;"DISP:WINDLO:GRAP:MOVE 55,18 
;LAB ’>>>>> Press NORMALIZE <<<<<’?" 


WAIT .2 

OUTPUT @Hp8711;"DISP:WIND1O:GRAP:MOVE 55,18 
;LAB ’ Press NORMALIZE as 

WAIT .2 
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450 END LOOP 


451 

460 Norm: ! Entry point to wait for a key press. 
461 : 

462 ! If wrong key pressed, return to Normalize. 
470 IF Keycode&0 THEN GOTO Normalize 

480 OFF KEY 

481! 

482 ! The through should now be connected and 
483 ! ready to measure. 

484 ! 

485 ! Turn the graphics buffer back on. 


490 OUTPUT GHp8711;"DISP:WIND10:GRAP:BUFF ON" 
1 


494 ! 
492 ! Select the “erase” pen (pen color 0) and 
493 ! erase the prompts. 


500 OUTPUT @Hp8711;"DISP:WIND10:GRAP:COL O;MOVE 55,18 
;LAB °>>>>> Press NORMALIZE <<<<<?" 

510 OUTPUT @Hp8711;"DISP:WIND10:GRAP:MOVE 1,50 
:sLAB ’Connect THRU between RF OUT and RF IN’" 


520 OUTPUT @Hp8711;"DISP:MENU:KEY1 ° as 

B22 1 

522 ! Display the active data trace only. Turn off 
523 1! any previous normalization. 

530 OUTPUT @Hp8711;"CALC2:MATH CIMPL)* 

631 1 

532 ! Take a single sweep on channel 2. 

540 OUTPUT @Hp8711;"INIT2;*WAI" 

541 

542 |! Copy the new data trace into the memory array. 
550 OUTPUT @Hp8711;"TRAC CH2SNEM ,CH2SDATA" 

551} 

552 ! Normalize; that is, display the active data 
553 |! relative to the memory trace. 

560 OUTPUT OHp8711;"CALC2:MATH CIMPL/CH2SMEM)" 
561! 

562 |! Display only one of the traces (the normalized 


563 ! trace). 

570 OUTPUT @Hp8711;"DISP:WIND2:TRAC1 ON;TRAC2 OFF" 

571! 

572 | Erase the through connect and select pen color 1 again. 
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580 OUTPUT GHp8711;"DISP:WIND10:GRAP:MOVE 290,110 
;DRAW 425,110;DRAW 425,125;COL 1" 
590 STEP 
600 ! 
610 Srq: ! This is the branching routine that handles 
service request 


611 ! generated interrupts. 

612 1 

613  ! Do a serial poll to find out if analyzer generated the 
614 ! interrupt. 

620 Stb=SPOLL(@Hp87 11) 

621 3! 

622 ! Determine if the Device Status register’s summary 
623 ! bit (bit 2 of the Status Byte) has been set. 

630 IF BINAND(Stb,4)&0 THEN 

631 t 

632 ! If so, then get the Device Status Register contents. 
640 OUTPUT GHp8711;"STAT:DEV:EVEN?” 

650 ENTER @Hp8711;Dev_event 

651 1 

652 ! Check for key press... 

660 IF BINAND(Dev_event ,1)&0 THEN 

661 ! If so, then determine which key. 

670 OUTPUT @Hp8711; "SYST: KEY?" 

680 ENTER @Hp8711;Keycode 

690 END IF 

700 END IF 

7o1 3 

702  }! Reenable the interrupt in case wrong key 

703 ! was pressed. 


710 ENABLE INTR Isc 
720 ©6GOTO Norm 
730 END 
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GRAPH2 Example Program 


This program demonstrates simple graphics and softkey handling. If the 
program is ran from an external computer, it also demonstrates basic 
interrupts (SRQ) and status register handling. The program displays a 
hookup diagram and requests the user to connect a cable. Once the cable is 
connected the user is prompted to press a “NORMALIZE” key. The analyzer 
then performs the normalization and erases the hookup diagrarn. 


Filename: GRAPH2 


Description: Draws a simple connection diagram 
in the IBASIC window, and displays a softkey. 


NOTE: This program works properly ONLY 
when option 1C2, IBASIC, has been installed. 
Modify to use DISP:WIND1 if no IBASIC option. 


i 

COM /Sys_state/ @Hp87xx ,Scode 
! Identify I/0 Port 

CALL Iden_port 

13 


output @Hp87xx;"DISP :WIND1:GRAP :SCAL 0,1023,0,383" 
: 
! Allocate an IBASIC display partition 
! to show the graphics. 
QUTPUT @Hp87xx;"DISP:FORM ULOW" 
OUTPUT @Hp87xx;"DISP:WIND1:TRAC:GRAT:GRID OFF" 
1 


! Clear the IBASIC display partition. 
OUTPUT @Hp87xx;"DISP:WIND1:GRAP:CLE" 
t 


$ Turn on channel 2 for measurements. The 
! lower part of the display is 

! devoted to display of measurements. 
OUTPUT @Hp87xx;"SENS2:STAT ON;*WAI" 


! Take a single controlled sweep to ensure 
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! a valid measurement using *OPC query. 

OUTPUT GHp87xx;"ABOR; :INIT2:CONT OFF; :INIT2;*0PC?" 
ENTER @Hp87xx; Ope 

1 

! Select the bright “pen" and bold font. 

OUTPUT GHp87xx;"DISP:WIND1:GRAP:COL 1;LAB:FONT BOLD” 
i 

! Draw a label reading “HP 8711C" at 45 pixels 

! to the right and 120 pixels above the origin. 

! The origin is the lower left corner of the 

! current graphics window (upper half). 

np @Hp87xx;"DISP:WIND1:GRAP:MOVE 45,120;LAB ’HP 871107" 


Draw a box to represent the analyzer. 

OUTPUT GHp87xx ;"DISP :WIND1:GRAP :MOVE 30,175;DRAW 30,140;DRAW 
480 ,140;DRAW 480,175" 

i 

! Draw a box to represent the REFLECTION RF OUT port. 

OUTPUT GHp87xx;"DISP :WIND1:GRAP:MOVE 275,140;DRAW 275 ,130;DRAW 
305 ,130;DRAW 305,140" 

! Draw a box to represent the TRANSMISSION RF IN port. 

OUTPUT @Hp87xx;"DISP:WIND1:GRAP:MOVE 410,140;DRAW 410,130;DRAW 
440 ,130;DRAW 440,140" 

! Change the text font to small, which is the 

! same as that used for PRINT or DISP statements. 

OUTPUT @Hp87xx;"DISP :WIND1:GRAP:LAB: FONT SMAL" 


1520 ! 


1530 
1540 


! Label the RF QUT port. 
QUIPUT @Hp87xx;"DISP:WIND1:GRAP:MOVE 250,145;LAB ’°RF OUT’" 


1550 ! 


1860 
1570 


! Label the RF IN port. 
OUTPUT @Hp87xx;"DISP:WIND1:GRAP:MOVE 380,145;LAB °RF IN?" 


1580 ! 


1590 
1600 
1610 
1620 
1630 


1640 
1650 


Normalize: ! 

1 

! Draw a through connection between the RF OUT 

$ and RF IN ports. 

OUTPUT @Hp87xx;"DISP:WIND1:GRAP:MOVE 290,125;DRAW 290,110;DRAW 
425,110;DRAW 425,125" 

! Prompt the operator to connect the through. 

OUTPUT @Hp87xx;"DISP:WIND1:GRAP:MOVE 1,50;LAB 7Connect THRU between RF 
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OUT and RF IN’" 
IF Internal=1 THEN 
! If using the IBASIC (internal) controller, 
! then use the "ON KEY" method to handle 
! user interface. 
ON KEY 1 LABEL "NORMALIZE" RECOVER Norm 
ELSE 
! Tf using an external controller... 


: 
! Initialize flag for checking on keyboard 
! interrupts. 

Keycode=-1 


! Label softkey 1. 
OUTPUT @Hp87xx;"DISP:MENU:KEY1 ’NORMALIZE’" 


! Clear the status register and event status 
! register. 
OUTPUT @Hp87xx;"*CLS;*ESE 0” 


Preset the other status registers. 
Enable the Device Status register to report 
to the Status Byte on positive transition 
of bit 0 (key press). Enable the Status 
Byte to generate an interrupt when the 
Device Status register’s summary bit 
changes. 
OUTPUT @Hp87xx;"STAT:PRES;DEV:ENAB 1;+*SRE 4" 


! Clear the key queue to ensure that previous 
! key presses do not generate an interrupt. 
OUTPUT GHp87xx; "SYST: KEY: QUE: CLE" 


! Set up and enable the interrupt on the HP-IB 
! when a service request is received. 
ON INTR Scode,5 RECOVER Srq 
ENABLE INTR Scode;2 
END IF 
t 
! Turn off the graphics buffer. 
OUTPUT @Hp87xx;"DISP:WIND1:GRAP:BUFF OFF" 
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! 
! Loop for waiting for press of the NORMALIZE key. 
! The two different output statements along with 
! the wait statements create a blinking effect. 
! There is not exit from this loop other than 
! a keyboard interrupt. 
LOOP 
OUTPUT @Hp87xx;"DISP:WIND1:GRAP:MOVE 55,18;LAB ?>>>>> 
NORMALIZE <<<<<’" 
WAIT .2 
OUTPUT @Hp87xx;"DISP:WIND1:GRAP:MOVE 55,18;LAB ’ 
NORMALIZE sa 
WAIT .2 
END LoaP 
i 
Norm: ! Entry point to wait for a key press. 
1 
! If wrong key pressed, return to Normalize. 
IF Keycode<>0 THEN GOTO Normalize 
OFF KEY 
! 


! The through should now be connected and 
! ready to measure. 
! 
: 


Turn the graphics buffer back on. 
OUTPUT @Hp87xx;"DISP:WIND1:GRAP:BUFF ON* 
t 


! Select the “erase” pen (pen color 0) and 
! erase the prompts. 


Press 


Press 


OUTPUT GHp87xx;"DISP:WIND1:GRAP:COL 0;MOVE 55,18;LAB ’>>>>> Press 


NORMALIZE <<<<<?"' 


OUTPUT @Hp87xx;"DISP:WIND1:GRAP:MOVE 1,50;LAB ?Connect THRU between RF 


OUT and RF IN’" 
OUTPUT GHp87xx;"DISP:MENU:KEY1 ’ ait 
t 


! Display the active data trace only. Turn off 
! any previous normalization. 

OUTPUT @Hp87xx;"CALC2:MATH CIMPL)" 

t 


! Take a single sweep on channel 2. 
OUTPUT @Hp87xx;"INIT2;*WAL" 
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2430 ! 

2440 | Copy the new data trace into the memory array. 

2450 OUTPUT GHp87xx;"TRAC CH2SMEM ,CH2SDATA" 

2460 ! 

2470 | Normalize; that is, display the active data 

2480 ! relative to the memory trace. 

2490 QUTPUT @Hp87xx;"CALC2:MATH (CIMPL/CH2SMEM)" 

2500 ! 

2510 ! Display only one of the traces (the normalized 

2520 ! trace). 

2530 OUTPUT @Hp87xx;"DISP:WIND2:TRAC1 ON;TRAC2 OFF" 

2540 ! 

2550 ! Erase the through connect and select pen color 1 again. 

2560 OUTPUT @Hp87xx;"DISP:WIND1:GRAP:MOVE 290,125;DRAW 290,110;DRAW 
425,110;DRAW 425,125" 

2570 STOP 

2580 ! 

2590 Srq: | This is the branching routine that handles service request 

2600 ! generated interrupts. 

2610 ! 

2620 ! Do a serial poll to find out if analyzer generated the 

2630 ! interrupt. 

2640 Stb=SPOLL(@Hp87xx) 

2650 ! 

2660 ! Determine if the Device Status register’s summary 

2670 ! bit (bit 2 of the Status Byte) has been set. 

2680 IF BINAND(Stb,4)<>0 THEN 

2690 ! 

2700 ! If so, then get the Device Status Register contents. 

2710 OUTPUT @Hp87xx; "STAT: DEV : EVEN?" 

2720 ENTER @Hp87xx ;Dev_event 


2730 ! 

2740 ! Check for key press... 

2750 IF BINAND(Dev_event,1)<>0 THEN 
2760 ! If so, then determine which key. 
2770 QUIPUT @Hp87xx; "SYST: KEY?" 
2780 ENTER @Hp87xx ; Keycode 

2790 END IF 

2800 END IF 

2810 } 


2820 | Reenable the interrupt in case wrong key. 
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2840 
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2870 ! 


2880 
2890 
2900 


2910 ! 


2920 
2930 
2940 
2950 
2960 
2970 
2980 
2990 
3000 
3010 
3020 
3030 
3040 
3050 
3060 


3070 ! 


! was pressed. 
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ENABLE INTR Scode 


GOTO Norm 
END 


Ineo RGB OH Rag Fao dada aaa aoias koi a ae sake kak tok ik 


! Iden_port: 
! Description: 
E 


Identify io port to use. 

This routines sets up the I/O port address for 
the SCPI interface. For "HP 87xx" instruments, 
the address assigned to @Hp87xx = 800 otherwise, 
716. 


eof i eo ok oe 2k i ok fe 2 ok aoe ca a of He ie a fe a eo fa 2 2 ak oe oe afc oe 9 2 of ae oe a fe a ae eae a a a ae of oi ak ae ae 


SUB Iden_port 


COM /Sys_state/ @Hp87xx,Scode 


IF POS(SYSTEM$("SYSTEM ID") ,"HP 87")<>0 THEN 
ASSIGN @Hp87xx TO 800 
Scode=8 


ELSE 


ASSIGN @Hp87xx TO 716 
Scode=7 


END IF 
i 


SUBEND !Iden_port 
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250 ! 


250 
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280 
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GETPLOT Example Program 


This program shows how to capture a screen plot in “.hgl’ format and 
transfer it to the floppy drive. Although this capability now exists in 
firmware, this program is still useful in demonstrating file manipulation and 
storage. This program also allows the user to specify any filename, whereas 
the firmware will always choose a predefined name. This can also be used for 
“ pex” format by un-commenting line 280. 


Because of BASIC limitations in any single array size, a four element array 
is used in line 170 to store the complete file. This allows a file size up to 
128,000 bytes. 


Lines 320 ~ 340 enter the screen capture data into the array BIk$. 
Lines 360- 380 determine the total number of bytes to be saved. 


Lines 410 - 480 save the file. In line 420, any previous file of the same name 
is erased. If no file exists, this line is ignored due to the ON ERROR staternent 
in line 410. The file is created in line 450 and the data stored in line 470. 


!GETPLOT 


! 

! This program will get a hardcopy screen dump in HP-GL format from 
! the 8711, and store it locally. 
! 
[ 
t 


The user specifies the local filename (default = Plot871x) 


DIM B1k$(1:4)[32000] ! Max file size = 4 * 32000 


t 


128000 bytes 


DIM Filename$[64] ,Dest$[64] 
INTEGER Word1 

! 

COM /Sys.state/ @Hp87xx ,Scode 
! Identify I/0 Port 


CALL Iden_port 
t 


BEEP 
Filename$="DATA:screen.hgi" |! HP-GL format 
! Filename$="DATA:screen.pcx" ! PCX format 


Dest$="Plots7ix" 
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300 
310 
320 
330 
340 
350 
360 
370 
380 
390 
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420 
430 
440 
450 
460 
470 
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490 
00 
§10 


520 ! 


530 
540 
550 
560 
$70 
580 
590 
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INPUT "Enter host filename (default=’Plot871x’)",Dest$ 
DISP "READING FILE "&Filename$&" ..." 
OUTPUT @Hp87xx;"MMEM: TRANSFER? °"&Filename$&"’" 
ENTER @Hp87xx USING "#,W";Wordi ! Assume indefinite block: #0 header 
ENTER @Hp87xx USING "%,-K" ;Blk$(*) 
! Compute length of data we just ENTERed 
FOR I=1 TO 4 
Filelength=LEN(BLk$(I))+Filelength 
NEXT I 
! Save data to local file 
DISP "Creating new file..." 
ON ERROR GOTO Save_file 
PURGE Dest$ 
Save file: i 
OFF ERROR 
CREATE Dest$ ,Filelength 
ASSIGN @File TO Dest$;FORMAT ON 
OUTPUT OF ile ;Blk$ (+); 
ASSIGN @File TO * 
DISP "File "&Dest$&" created." 
BEEP 


END 
f 


[lgGadoia Ga a ES CSS GR A a GIISI KI ACR A aSHC I CR ACI A A aa 
{ Iden_port: Identify lo port to use. 

! Description: This routines sets up the I/0 port address for 

i the SCPI interface. For "HP 87xx" instruments, 
! the address assigned to @Hp87xx = 800 otherwise, 
1 716. 

Dggoaacoiok agora a ac GCG A SIGIR II RSI ICICI A aR AE Fk a 
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600 SUB Iden_port 


610 COM /Sys.state/ @Hp8?7xx ,Scode 
620 ! 

630 IF POS(SYSTEM$("SYSTEM ID") ,"HP 87")<>0 THEN 
640 ASSIGN @Hp87xx TO 800 

650 Scode=8 

660 ELSE 

670 ASSIGN @Hp87xx TO 716 

680 Scode=7 

6390 END IF 

700 # 

710 SUBEND !Iden_port 

720 | 
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Annotation 


USERANOT Using user-defined annotation. 
FREQBLNK Concealing sensitive frequency information. 
KEYCODES Reading key presses and knob positions from the analyzer. 
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230 ! 


300 
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USERANOT Example Program 


This program demonstrates how to use user-defined x-axis annotation. With 
this feature, you can set the analyzer to convert all x-axis information into 

a user-defined scale, In this program, the Channel 1 x-axis is modified to 
display antenna angle in degrees while Channel 2 x-axis displays antenna 
height in feet. 


'RE-SAVE "USERANOT" 

IBASIC program: An example program to draw user-defined annotation 
f$Revision: 1.1 $ 

!$Date: 97/09/02 13:14:22 $ 

1 


Demonstrate these SCPI commands: 


DISPlay: ANNotation:CHANnel [1!2]:USER[:STATe] {OFF[OIONi 1} 
DISPlay: ANNotation:CHANnel [1|2]:USER:LABel[:DATA] <STRING> 


DISPlay : ANNotation:FREQuency [112] :USER:STARt #-10000~10000# 
DISPlay : ANNotation:FREQuency[1|2] :USER:STOP #-100007 10000# 
DISPlay : ANNotation:FREQuency [1|2]:USER:SUFFix[:DATA] <STRING> 


I 

t 

i 

! 

! 

! DISPlLay: ANNotation:FREQuency [112] :USER[:STaTe] {OFF/O{ON]1} 

i 

! 

H 

! - DISPLay:ANNotation:FREQuency [1|2] :USER:LAaBel[: DATA] <STRING> 
I 


Dee cee me eo a ee a nr mt i ir mmm a lm mt a a, 
1 
! Determine select code (800 for IBASIC, 716 for external computer) 
' 
IF POS(SYSTEM$ ("SYSTEM ID") ,"HP 87") THEN 
ASSIGN @Hp8711 TO 800 
ELSE 
ASSIGN @Hp8711 TO 716 
ABORT 7 
CLEAR 716 
END IF 
! 
! Preset 
OUTPUT @Hp8711;"SYST:PRES; *WAI" 
OUTPUT @Hp8711;"SENS2:STAT ON" ! So we can see markers 


8-126 & indicates HP 8712C/14€ only 


Example Programs 
Annotation 


410 OUTPUT @Hp8711;"*OPC?" 
420 ENTER @Hp8711;0pc 
t 


430 ! 

440 ! Set up channel annotation using: 

450 ! DISPlay : ANNotation:CHANnel [1] 2] :USER[:STATe] {OFF /OfON|1} 
460 | DISPlay:ANNotation:CHANnel [112] :USER:LABel [:DATA] <STRING> 
A470 ! 


480 DISP "Setting up channel annotation..." 

500 OUTPUT @Hp8711;"DISP:ANN:CHAN1:USER:STAT 1" 

510 OUTPUT @Hp8711;"DISP:ANN:CHAN1:USER:LABEL ’Ch 1 Custom Annot: Signal vs. 
Antenna angle’" 

520 OUTPUT @Hp8711;"DISP:ANN:CHAN2:USER:STAT 1" 

530 OUTPUT @Hp8711;"DISP:ANN:CHAN2:USER:LABEL ’Ch 2 Custom Annot: Signal vs. 
Antenna height’" 

540 DISP "Setting up channel annotation... Done." 


550 WAIT 3 
560 ! 
570 ! Set up frequency annotation using: 


t 
680 | DISPlay:ANNotation:FREQuency[112]:USER[:STATe] {OFF[0|ON|1} 
590! DISPlay:ANNotation: FREQuency[1|/2] :USER:STARt #-10000~10000# 

1 

if 

i 


600 DISPlay : ANNotation:FREQuency[112]:USER:STOP #-100007 10000# 
610 DISPlay : ANNotation : FREQuency[1!2] :USER:SUFFix[: DATA] <STRING> 
620 ! 

630 DISP "Setting up frequency annotation..." 

650 ! 


660 OUTPUT @Hp8711;"DISP:ANN:FREQ1:USER:LABEL ’Antenna Angle’" 
670 OUTPUT @Hp8711;"DISP:ANN:FREQ1:USER:STAT 1" 

680 OUTPUT @Hp8711;"DISP: ANN: FREQ1: USER: START -180.0" 
690 OUTPUT @Hp8711;"DISP: ANN: FREQ1:USER:STOP 180.0" 
700 OUTPUT @Hp8711;"DISP:ANN:FREQ1:USER:SUFFIX ’Deg’" 
720 | 

730 OUTPUT @Hp8711;"DISP:ANN:FREQ2:USER:LABEL *Height’" 
740 QUIPUT @Hp8711;"DISP:ANN:FREQ2:USER:STAT 1" 

750 OQUIPUT @Hp8711;"DISP: ANN: FREQ2:USER:START 5280.0" 
760 OUTPUT @Hp8711;"DISP:ANN:FREQ2:USER:STOP -1760.0" 
770 OUTPUT @Hp8711;"DISP: ANN: FREQ2:USER:SUFFIX ?Ft’" 

780 ! 

790 DISP "Done. Markers will read out using new units!" 
800 OUTPUT @Hp8711;"CALC1:HARK1 ON” 

810 OUTPUT @Hp8711;"CALC2:MARK1 ON” 

820 ! 
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830 LOCAL @Hp8711 
840 } 
850 END 'End of this program 
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FREQBLNK Example Program 


This program demonstrates how to use user-defined x-axis annotation to 
conceal (or “blank”) sensitive frequency information. 


!RE-SAVE "FREQBLNK" 

!BASIC program: An example program to overwrite frequency annotation 
!$Revision: 1.2 $ 

!$Date: 97/09/02 13:17:25 $ 

1 


Demonstrate using these SCPI commands to blank freq annotation. 


t 

7 

!  DISPlay :ANNotation:FREQuency [112] :USER[:STATe] {OFF|0{ON|i} 

i ISPlay : ANNotation:FREQuency (112]:USER:STARt #-10000~10000# 

i DISPlay :ANNotation:FREQuency [112] :USER:STOP #-100007 10000# 

1 DISPlay: ANNotation:FREQuency [1]2]:USER:SUFFix[:DATA] <STRING> 
| DISPlay :ANNotation:FREQuency[112]:USER:LABel[:DATA] <STRING> 

t 


Bc i ee a a me Hw 0 me eer at erm rs = ta te ym 
1 
! Determine select code (800 for IBASIC, 716 for external computer) 
t 
IF POS(SYSTEM$ ("SYSTEM ID") ,"HP 87") THEN 
ASSIGN @Hp8711 TO 800 
ELSE 
ASSIGN @Hp8711 TO 716 
ABORT 7 
CLEAR 716 
END IF 
1 
! Preset 
QUTPUT @Hp8711;"SYST:PRES; *WAI" 
OUTPUT @Hp8711;"SENS2:STAT ON" ! So we can see markers 
OUTPUT @Hp8711;"*0PC?" 
ENTER @Hp&711; Ope 
t 


! Set up frequency annotation using: 
} DISPLay : ANNotation:FREQuency[1|2] :USER[:STATe] {OFFIO|ON|1} 
!  DISPLay: ANNotation:FREQuency[1]2]:USER:STARt #-10000710000# 
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Annotation 
440 | DISPlay : ANNotation:FREQuency[1]2]:USER:STOP #-10000~ 10000# 
450 ! DISPlay:ANNotation:FREQuency[1|2] :USER:SUFFix[:DATA] <STRING> 
460 ! 
470 DISP "Setting up frequency annotation..." 
480 ! 


490 QUTPUT QHp8711;"DISP:ANN:FREQ1:USER:LABEL ’Blank’" 
500 OUTPUT @Hp8711;"DISP: ANN: FREQ1:USER:STAT 1" 

510 QUIPUT @Hp8711;"DISP:ANN:FREQ1:USER:START 0.0" 

520 OUTPUT @Hp8711;"DISP:ANN:FREQ1:USER:STOP 100.0" 
530 OUTPUT @Hp8711;"DISP:ANN:FREQ1:USER:SUFFIX °’" 

540 ! 

550 OUTPUT @Hp8711;"DISP:ANN:FREQ2:USER:LABEL ’Blank’" 
560 OUTPUT @Hp87i1;"DISP:ANN:FREQ2:USER:STAT 1" 

570 OUTPUT @Hp8711;"DISP:ANN:FREQ2:USER:START 0.0" 

580 OUTPUT @Hp8711;"DISP:ANN:FREQ2:USER:STOP 100.0" 
590 OUTPUT @Hp8711;"DISP: ANN :FREQ2:USER:SUFFIX ’?" 

600 ! 

610 DISP “Done. Markers will read out using new units!” 
620 OUTPUT @Hp8711;"CALC1:MARK1 ON" 

630 OUTPUT @Hp8711;"CALC2:MARKi ON" 

640 ! 

650 LOCAL @Hp8711 

660 ! 

670 END 'End of this program 
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KEYCODES Example Program 


This program will detect any front panel input, determine if it is from a 
keystroke or the knob, and display the corresponding keycode or value. Each 
key has a unique keycode associated with it. The knob will return either a 
positive or negative number depending upon direction of rotation (clockwise 
is positive). The program can be exited by pressing (PRESET). 


Lines 1290 ~ 1520 are continuously repeated to look for any front panel 
activity. 


Line 1370 - 1430 read the key type to determine if the activity came from a 
key press or from the knob. Also read is the value “Key.code.” If the activity 
came from the knob, then the value “Key_code” represents how far the knob 
has been turned, and in which direction. If the activity came from a key 
stroke, the value represents the key’s keycode. 


Line 1510 determines if the key was pressed. If so, the program 
exits. 


1000 ! Filename: KEYCODES 

1010 ' _ 

1020 ! 

1030 ! Demonstration of how to read the analyzer’s 
1040 ! front panel keys and knob, as well as external 
1050 ! PC keyboard, using the SCPI SYST: KEY commands. 
1060 | This program reads key presses and knob turn 
1070 ! ticks and displays them on the screen. 

1080 ! L 

1090 ! 

1100 DIM Msg$[40] 

1110 ! 

1120 ! 


1130 COM /Sys_state/ @GHp87xx,Scode 
1140 | Identify I/0 Port 

1150 CALL Iden_port 

1160 ! 

1170 ! 

1180 ! Clear the key queue to ignore 
1190 ! previous key presses. 
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1200 
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1250 
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1270 
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1390 
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1420 
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1470 
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1490 
1500 
1510 
1520 
1530 
1540 
1550 
1560 


OUTPUT OHp87xx;"SYST:KEY: QUE: CLE" 

! 

! Turn on the Key queue off to limit 

' maximum que size to one. 

OUTPUT @Hp87xx;"SYST:KEY:QUE OFF" 

! 

Msg$="’Press keys or turn knob. PRESET ends.’" 
OUTPUT @Hp87xx;"DISP:ANN:MESS:DATA ";Msg$ 


t 
LOOP 
{ Query device status condition register 
OUTPUT @Hp87xx;"STAT:DEV: COND?” 
ENTER @Hp&7xx;Dev_cond 
t 
! Check the bit that indicates a key press. 
IF BIT(ev_cond,0)=1 THEN 
! Read the key type first 
OUTPUT @Hp87xx; "SYST: KEY: TYPE?" 
ENTER @Hp87xx;Key_type$ 
! Read the key code last. 
! This removes it from the queue 
OUTPUT GHp87xx; "SYST: KEY?" 
ENTER @Hp87xx; Keycode 
DISP "Keycode ";Key_code;" Type ";Key_type$; 
! See how many more keys are in the queue 
OUTPUT @Hp87xx; "SYST: KEY: QUEUE: COUNT?” 
ENTER @Hp87xx;Key.count 
DISP ". Keys in queue:";Key_count 
END IF 
' 
! Stop looping if the PRESET key was pressed. 
EXIT IF Key_code=56 AND Key_type$="KEY" 


END LOOP 
DISP "The end." 
OUTPUT @Hp87xx;"DISP:ANN:MESS:DATA ’The End.?" 


END 
! 
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$ Iden port: Identify io port to use. 
' Description: This routines sets up the I/0 port address for 
H the SCPI interface. For "HP 87xx'' instruments, 
! the address assigned to @Hp87xx = 800 otherwise, 
! 716. 
PTrrrtrrtttttrtirrrttietiriore cre erst te te te toe Se eee 
SUB Iden_port 
com /Sys_state/ @Hp87xx,Scode 
! 
IF POS(SYSTEM$("SYSTEM ID") ,"HP 87")<>0 THEN 
ASSIGN @Hp87xx TO 800 
Scode=8 
ELSE 
ASSIGN @Hp87xx TO 716 
Scode=7 
END IF 
t 


SUBEND !Iden_port 
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MKR.. MATH 


Marker math functions are used to calculate different 
parameters on a user-defined measurement trace segment. 
Frequency span, mean amplitude, amplitude standard 
deviation, and peak-to-peak amplitude are calculated with 
the Statistics function. Span, gain, slope and flatness are 
calculated with the Flatness function. Insertion loss and 
peak-to-peak ripple of the passband, and maximum signal 
amplitude in the stopband are calculated with the RF Filter 
Stats function. This example program steps through the 
marker math functions and then reads and reports the 
results. 
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MKR_MATH Example Program 


{Filename: MKR MATH 


This example program demonstrates how to program marker math 
functions. Marker Statistics, Marker Flatness, and RF Filter Stats. 


Connect the demo filter between the RF out and RF in of the analyzer. 


The program will step through various marker math measurements, then 
read and report the results. 


COM /Sys.state/ @Hp87xx,Scode 
! Identify I/0 Port 

CALL Iden_port 

i 


! Perform a system preset; 
OUTPUT @Hp87xx;"SYST:PRES ; *WAI" 
' 


! Set up the source frequencies for the measurement. 
OUTPUT @Hp87xx;"SENSi:FREQ:STAR 10 MHZ;STOP 400 MHZ;+WAI" 
1 


! Set up the receiver for the measurement parameters 

! (Transmission in this case). 

OUTPUT @Hp87xx;"SENS1:FUNC °XFR:POW:RAT 2,0°;DET NBAN; *WaI" 
t 

! Configure the display so measurement 

! results are easy to see. 

OUTPUT GHp87xx;"DISP:WIND1:TRAC:Y:PDIV.10 DB;RLEV 0 DB;RPOS 9" 
1 

! Reduce the distractions on the display by 

! getting rid of notation that will not be 

{ needed in this example. 

OUTPUT @Hp87xx;"DISP:ANN:YAX OFF" 

1 


! Erase the graticule grid for the same reason. 
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OUTPUT @Hp87xx;"DISP:WIND1:TRAC:GRAT:GRID OFF" 


! Set the markers for 


OUTPUT 
QUTPUT 
OUTPUT 
OUTPUT 
OUTPUT 
OUTPUT 
OUTPUT 
OUTPUT 
t 

! Turn 
OUTPUT 


DISP "Marker Flatness"” 


WAIT 5 
OUTPUT 


! Read the four values: 


@Hp87xx ;"CALC1: 
@Hp87xx; "CALC1: 
@Hp87xx;"CALC1: 
:MARK2 


@Hp87xx; "CALCI 


@Hp87 xx; "CALC1: 
@HpS87xx; "CALC1: 
:MARK4 
:MARK4 


@Hp87xx;"CALC1 
@Hp87xx; "CALC 


channel 1 


MARK1 
MARK 
MARK2 


MARKS 
MARKS 


on marker flatness 
@Hp87xx;"CALC1:MARK:FUNC FLATNESS" 


ON! 
2% 152000000 .000000" 
oN 
:X 200000000 .000000" 
on" 
:X% 279000000 .000000" 
ON" 
2X 388000000 .000000" 


@Hp87 xx; "CALC1:MARK: FUNC : RES?” 


the span, gain 


! the slope, and the flatness. 
ENTER @Hp87xx;Span ,Gain ,Slope,Flatness 
' 


! Display the results. 


BEEP 


DISP "Span ";Span 


WAIT & 
BEEP 


DISP "Gain ";Gain 
t 


WAIT 5 
BEEP 


DISP "Slope ";Slope 


WAIT 5 
BEEP 


DISP "Flatness ";Flatness 


WAIT 5 


! Turn on marker statistics 
OUTPUT @Hp87xx;"CALC1:MARK:FUNC STATISTICS" 
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DISP "Marker Statistics" 

1 

WAIT 5 

OUTPUT @Hp87xx;"CALCi:MARK: FUNC: RES?" 
! Read the four values: the span, 

! the mean, the sdev, peak to peak. 
ENTER @Hp87xx;Span,Mean,Sdev,Peak 

i 


! Display the results. 
BEEP 

DISP "Span ";Span 
t 

WAIT 5 

BEEP 

DISP "Mean ";Mean 
1 

WAIT 5 

BEEP 

DISP "Sdev ";Sdev 
t 

WAIT 5 

BEEP 

DISP "Peak ";Peak 
1 


WAIT 5 

! Turn on RF Filter Stats 

OUTPUT @Hp87xx;"CALC1:MARK:FUNC FST" 
DISP "RF Filter Stats" 

' 

WAIT §& 

OUTPUT @Hp87xx;"CALC1:MARK:FUNC: RES?" 
! Read the three values: the loss, 
! the peak to peak, and the reject 
ENTER GHp87xx;Loss ,Peak,Reject 

i 


! Display the results. 
BEEP 

DISP "Loss ";Loss 

i 

WAIT 5 

BEEP 
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DISP "Peak ";Peak 


' 

WAIT 5 

BEEP 

DISP "Reject ";Reject 

1 

WAIT 5 

DISP "Done" 

END 

: 

Deere rae SHC EE SSSI AIO IS IIS RE a ak ak A a i i a kak a 
! Iden. port: Identify io port to use. 

! Description: This routines sets up the 1/0 port address for 

! the SCPI interface. For "HP 87xx" instruments, 
§ the address assigned to @Hp87xx = 800 otherwise, 
p 716. 

Digbaol aoa ods oa dob io da oto dati i ISR I ie i ak ak ak ak ak dk ak a aR 
SUB Iden_port 


' 


com /Sys.state/ @Hp87xx,Scode 


IF POS(SYSTEM$("SYSTEM ID"),"HP 87")<>0 THEN 
ASSIGN CHp87xx TO 800 
Scode=8 
ELSE 
ASSIGN @Hp87xx TO 716 
Scode=7 
END IF 


SUBEND !Iden_port 


I 


8-138 & indicates HP 8712C/14C only 


Marker Limit Testing 


LIM_FLAT 


LIM_PEAK 


LIM-MEAN 


Limit testing can be performed on the flatness of a 
user-defined measurement trace segment. This example 
program sets various flatness limits, then queries the status 
to determine if the limit test passes or fails. 


Limit testing can be performed on the peak-to-peak ripple of 
a user-defined measurement trace segment. This example 
program sets various peak-to-peak limits, then queries the 
status to determine if the limit test passes or fails. 


Limit testing can be performed on the mean amplitude of a 
user-defined measurement trace segment. This example 
program sets various mean limits, then queries the status to 
determine if the limit test passes or fails. 


& indicates HP 8712C/14C only 8-139 


Example Programs 
Marker Limit Testing 


LIM_FLAT Example Program 


10 !Filename: LIM_FLAT 


20 1 

30 1! This example program demonstrates how to test for a marker 
40 ! flatness limit. 

bo! 

60 ! Connect the demo filter to the analyzer RF out and RF in. 
70 |! The analyzer will set-up a transmission measurement. 
go! 

90 ! The program will set various flatness limits, then query the 
100 ! status to determine if the specification PASSES or FAILS. 
110)! 

120 !} 

130 IF POS(SYSTEM$("SYSTEM ID"),"HP 871") THEN 

140 ASSIGN @Hp8711 TO 800 

150 ~—s ELSE 

160 ASSIGN @Hp8711 TO 716 

170 ABORT 7 

180 CLEAR 716 

190 END IF 

200 +! 


210 ! Perform a system preset; this clears the limit table. 

220 OUTPUT @Hp8711;"SYST:PRES ; *WAI" 

230 ! 

240 ! Set up the source frequencies for the measurement. 

250 OUTPUT @Hp8711;"SENS1:FREQ:STAR 10 MHZ;STOP 400 MHZ; *WAI" 
260 ! 

270 |! Set up the receiver for the measurement parameters 

280 ! (Transmission in this case). : 
290 OUTPUT @Hp8711;"SENS1:FUNC ’XFR:POW:RAT 2,0’ ;DET NBAN;*WAI" 
300 ! 

310 ! Configure the display so measurement 

320 ! results are easy to see. 

330 OUTPUT GHp8711;"DISP:WIND1:TRAC:Y:PDIV 10 DB;RLEV 0 DB;RPOS 9" 
340 ! 

350 ! Reduce the distractions on the display by 

360 ! getting rid of notation that will not be 


8-140 & indicates HP 8712C/14C only 
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Example Programs 
Marker Limit Testing 


! needed in this example. 
OUTPUT @Hp8711;"DISP:ANN:YAX OFF" 
t 


! Erase the graticule grid for the same reason. 
OUTPUT @Hp8711;"DISP:WIND1:TRAC:GRAT:GRID OFF" 
t 


! Set the markers for channel 1 
OUTPUT @Hp8711;"CALC1:MARKi ON" 
OUTPUT @Hp8711;"CALC1:MARK1:X 152000000 .000000" 
OUTPUT @Hp8711;"CALC1:MARK2 ON" 
OUTPUT @Hp8711;"CALC1:MARK2:X 200000000 .000000" 
1 
! Turn on marker flatness 
OUTPUT @Hp8711;"CALC1:MARK: FUNC FLATNESS" 
t 
QUIPUT @Hp8711;"CALCi:MARK2 ON" 
QUIPUT @Hp8711;"CALCi:LIM:DISP ON” 
QUTPUT @Hp8711;"CALC1:LIM:MARK: FLATNESS ON" 
1 
! Turn on the pass/fail testing; watch the 
! analyzer’s display for the pass/fail indicator. 
OUTPUT @Hp8711;"CALC1:LIM:STAT ON” 
I 


! Set sweep hold mode 
OUTPUT @Hp8711;"ABOR;:INITi:CONT OFF; :INIT1;+*WAI" 
1 
! Send an operation complete query to ensure that 
! all overlapped commands have been executed. 
QUIPUT @Hp8711;"*OPC?" 
i 


$ Wait for the reply. 
ENTER @Hp&711;0pc 
1 


! Turn on a limit to be tested 
FOR Flatness=0. TO 3 STEP .1 
DISP "Flatness limit test =",VAL$(Flatness)&" dB" 
OUTPUT @Hp8711;"CALC1:LIM:MARK: FLAT: MAX "VALS (Flatness) 
1 
! Take a controlled sweep to ensure that 
! there is real data present for the limit test. 
OUTPUT @Hp8711;"INIT1;*OPC?" 


SS indicates HP 8712C/14C only 
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Exampie Programs 
Marker Limit Testing 


ENTER @Hp8711; Ope 


! Query the limit fail condition register to see 
! if there is a failure. 
OUTPUT @Hp8711;"STAT:QUES:LIM: COND?" 


! Read the register’s contents. 
ENTER ¢Hp8711;Fail_flag 


Bit 0 is the test result for channel 1 while 
Bit 1 is the results for channel 2 limit testing. 
Bit 2 is the result for channel 1 mkr Limit testing. 
Bit 3 is the result for channel 2 mkr limit testing. 
IF BIT(Fail_flag,2)=1 THEN 
! This limit test failed 
ELSE 
DISP "Flatness passed at "£VAL$(Flatness)&" dB" 
BEEP 
GOTO Done 
END IF 


NEXT Flatness 
Done: OUTPUT @Hp8711;"INIT:CONT ON; *WAI" 
END 


8-142 & indicates HP 8712C/14€ only 


Exampie Programs 
Marker Limit Testing 


LIM_PEAK Example Program 


'Filename: LIM_PEAK 


This example program demonstrates how to test for a marker 
statistics peak to peak ripple limit. 


Connect the demo filter to the analyzer RF out and RF in. 
The analyzer will set-up a transmission measurement. 


The program will set various statistics peak to peak limits, then 


t 
! 
! 
! 
! 
i 
1 
1 
! query the status to determine if the specification PASSES or FAILS. 
! 

i 

t 


com /Sys.state/ @Hp87xx ,Scode 
! Identify I/O Port 

CALL Iden_port 

i 


a 

! Perform a system preset; this clears the Limit table. 
OUTPUT CHp87xx;"SYST:PRES; *WAI" 

! 


! Set up the source frequencies for the measurement. 
OUTPUT @Hp87xx;"SENS1:FREQ:STAR 10 MEZ;STOP 400 MHZ;*WAI" 
1 


! Set up the receiver for the measurement parameters 

! (Transmission in this case). 

OUTPUT GHp87xx;"SENS1:FUNC ’XFR:POW:RAT 2,0’ ;DET NBAN;*WAI" 
' 


! Configure the display so measurement 

! results are easy to see. 

OUTPUT GHp87xx;"DISP:WIND1:TRAC:Y:PDIV 10 DB;RLEV 0 DB;RPOS 9" 
3 


! Reduce the distractions on the display by 
! getting rid of notation that will not be 
! needed in this example. 

OUTPUT GHp87xx;"DISP:ANN:YAX OFF" 


68 indicates HP 8712C/14€ only 8-148 


Example Programs 
Marker Limit Testing 


1360 ! 

1370 ! Erase the graticule grid for the same reason. 
1380 OUTPUT @Hp87xx;"DISP:WIND1:TRAC:GRAT:GRID OFF" 
1390 ! 

1400 ! Set the markers for channel 1 

1410 OUTPUT @Hp87xx;"CALC1:MARK1 ON" 

1420 QUIPUT @Hp87xx;"CALC1:MARK1:X 152000000.000000" 
1430 OUTPUT @Hp87xx;"CALC1:MARK2 ON 

1440 OUTPUT @Hp87xx;"CALC1:MARK2:K 200000000. 000000" 
1450 ! 

1460 ! Turn on marker statistics 

1470 OUTPUT @Hp87xx;"CALC1:MARK:FUNC STATISTICS" 
1480 ! 

1490 OUTPUT @Hp87xx;"CALC1:MARK2 ON" 

1500 OUTPUT @Hp87xx;"CALC1:LIM:DISP ON" 

1510 OUTPUT GHp87xx;"CALC1:LIM:MARK:STAT:PEAK ON" 
1520 ! 

1530 | Turn on the pass/fail testing; watch the 

1540 ! analyzer’s display for the pass/fail indicator. 
1550 OUTPUT @Hp87xx;"CALC1:LIM:STAT ON” 

1560 ! 

1570 | Set sweep hold mode 

.1580 OUTPUT @Hp87xx;"ABOR; :INIT1:CONT OFF; :INIT1;*WALI" 
1590 ! 

1600 ! Send an operation complete query to ensure that 
1610 ! all overlapped commands have been executed. 
1620 OUTPUT @Hp87xx;"*0PC?" 

1630 ! 

1640 ! Wait for the reply. 

1650 ENTER @Hp87xx;Opc 

isé0 ! 

1670 ! Turn on a limit to be tested 

1680 FOR Peak. limit=0. TO 3 STEP .1 


1690 DISP "Peak limit test =",VAL$(Peak 1imit)&'" dB" 
1700 OUTPUT @Hp87xx;"CALC1:LIM:MARK:STAT:PEAK:MAX "&VAL$(Peak_ limit) 
1710 ! 


1720 ! Send an operation complete query to ensure that 
1730 ! all overlapped commands have been executed. 
1740 QUTPUT @Hp87xx;"*0PC?7" 

1750 } 

1760 ! Wait for the reply. 
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Example Programs 
Marker Limit Testing 


ENTER @Hp87xx;Opc 


! Take a controlled sweep to ensure that 

! there is real data present for the limit test. 
OUTPUT @HpS7xx;"INIT1;*0PC?" 
ENTER @Hp87xx; Opec 


! Query the limit fail condition register to see 
! if there is a failure. 
OUTPUT GHp87xx; "STAT: QUES :LIM: COND?" 


! Read the register’s contents. 
ENTER @Hp87xx;Fail_flag 
i 
! Bit O is the test result for channel 1 while 
! Bit 1 is the results for channel 2 limit testing. 
! Bit 2 is the result for channel 1 mkr limit testing. 
! Bit 3 is the result for channel 2 mkr limit testing. 
IF BIT(Fail.flag,2)+1 THEN 
! This limit test failed 
ELSE 
DISP "Passed at "&VAL$(Peak_limit)&" dB" 
BEEP 
GOTO Done 
END IF 
E 
NEXT Peak limit 
Done: OUTPUT @Hp87xx; "INIT: CONT ON; #WAI" 


END 
I 


ich dai aaa OK SOAS IGOR a i SC GE i a IAC aK CI ICR a a ao a ok ak 
! Iden.port: Identify io port to use. 

! Description: This routines sets up the I/0 port address for 

! the SCPI interface. For "HP 87xx" instruments, 
i the address assigned to @Hp87xx = 800 otherwise, 
‘ 716. 

Deogok dak do i ciabok ac BGI aC dO CK I ICRI kk i i a A OE A ACR OI i a 


€® indicates HP 8712C/14€ only 8-145 


Example Programs 
Marker Limit Testing 


2140 SUB Iden_port 


2150 COM /Sys_state/ @Hp87xx,Scode 
2160 ! 

2170 IF POSC(SYSTEM$ ("SYSTEM ID") ,"HP 87")<>0 THEN 
2180 ASSIGN @Hp87xx TO 800 
2190 Scode=8 

2200 ELSE 

2210 ASSIGN @GHp87xx TO 716 
2220 Scode=7 

2230 END IF 

2240 ! 

2250 SUBEND !Iden_port 

2260 ! 


8-146 SS indicates HP 8712C/14C only 


Example Programs 
Marker Limit Testing 


LIM_MEAN Example Program 


iFilename: LIM MEAN 


This example program demonstrates how to test for a marker 
statistics mean limit. 


i 

i 

1 

- 

! Connect the demo filter to the analyzer RF out and RF in. 
! The analyzer will set-up a transmission measurement. 
i 
1 

‘ 

! 

1 

1 


The program will set various statistics mean limits, then query 
the status to determine if the specification PASSES or FAILS. 


COM /Sys_state/ @Hp87xx,Scode 
! Identify I/O Port 

CALL Iden_port 

' 


t 


! Perform a system preset; this clears the limit table. 
OUTPUT @Hp87xx; "SYST: PRES; *WAI" 
1 


! Set up the source frequencies for the measurement. 
OUTPUT @Hp87xx;"SENS1:FREQ:STAR 10 MHZ;STOP 400 MHZ;+*WAI" 
i 


! Set up the receiver for the measurement parameters 

! (Transmission in this case). 

OUTPUT @Hp87xx;"SENS1:FUNC ’XFR:POW:RAT 2,0°;DET NBAN;*WAL" 
i 


! Configure the display so measurement 

! results are easy to see. 

OUIPUT @Hp87xx;"DISP:WIND1:TRAC:Y:PDIV 10 DB;RLEV 0 DB;RPOS 9" 
' 


! Reduce the distractions on the display by 
! getting rid of notation that will not be 
! needed in this example. 

OUTPUT GHpS7xx;"DISP:ANN:YAX OFF" 


& indicates HP 8712C/14C anly 8-147 


Example Programs 
Marker Limit Testing 


1360 ! 

1370 ! Erase the graticule grid for the same reason. 
1380 OUTPUT @Hp87xx;"DISP:WIND1:TRAC:GRAT:GRID OFF" 
1390 ! 

1400 ! Set the markers for channel 1 

1410 QUIPUT @Hp87xx;"CALC1:MARK1 ON" 

1420 OUTPUT GHp87xx;"CALC1:MARK1:X 152000000.000000" 
1430 OUTPUT @Hp87xx;"CALC1:MARK2 ON" 

1440 OUTPUT @Hp87xx;"CALC1:MARK2:X 200000000.000000" 
1450 ! 

1460 ! Turn on marker statistics 

1470 OUTPUT @Hp87xx;"CALC1:MARK:FUNC STATISTICS" 
1480 | 

1490 OUTPUT @Hp87xx;"CALCi:MARK2 ON” 

1500 OUTPUT @Hp87xx;"CALC1:LIM:DISP ON" 

1510 OUTPUT CHp87xx;"CALC1:LIM:MARK:STAT:MEAN ON" 
1520 | 

1530 ! Turn on the pass/fail testing; watch the 

1540 | analyzer’s display for the pass/fail indicator. 
1550 OUTPUT CHp87xx;"CALC1:LIM:STAT ON" 

1560 ! 

1570 | Set sweep hold mode 

1580 OUTPUT GHp87xx;"ABOR;:INIT1:CONT OFF; :INITi;*WAI" 
1890 ! 

1600 ! Send an operation complete query to ensure that 
1610 ! all overlapped commands have been executed. 
1620 OUTPUT @Hp87xx;"*OPC?" 

1630 ! 

1640 ! Wait for the reply. 

1650 ENTER @Hp87xx; Opec 

1660 ! 

1670 ! Turn on a limit to be tested 

1680 FOR Mean_limit=0. TO -5 STEP -.1 


1690 DISP "Mean limit test =",VAL$(Mean limit)&" dB" 
1700 OUTPUT @Hp87xx;"CALC1:LIM: MARK: STAT :MEAN :MIN "EVAL$ (Mean_limit) 
1710 ! 


1720 ! Send an operation complete query to ensure that 
1730 ! all overlapped commands have been executed. 
1740 OUTPUT @Hp87xx;"*0PCT" 

1750 } 

1760 ! Wait for the reply. 
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Example Programs 
Marker Limit Testing 


ENTER @Hp87xx ;Opc 


! Take a controlled sweep to ensure that 

! there is real data present for the limit test. 
OUTPUT @Hp&7xx;"“INIT1;*0PC?" 
ENTER GHp87xx ;Ope 


! Query the limit fail condition register to see 
1 if there is a failure. 
QUIPUT @Hp87xx; “STAT: QUES:LIN: COND?" 


! Read the register’s contents. 
ENTER @Hp87xx;Fail_flag 


Bit O is the test result for channel 1 while 

Bit 1 is the results for channel 2 limit testing. 

Bit 2 is the result for channel 1 mkr limit testing. 

Bit 3 is the result for channel 2 mkr limit testing. 
IF BIT(Pail_flag,2)=1 THEN 

! This limit test failed 


ELSE 
DISP “Passed at "&VAL$(Mean_limit)&" dB" 
BEEP 
GOTO Done 

END IF 


t 
NEXT Mean limit 
Done: OUTPUT @Hp87xx;"INIT:CONT ON; +*WAI" 


END 
1 


Dig oa SE GE GIS SE A CIRC CCIE a a5 1 a AR aA I A a ACS a 
! Iden_port: Identify io port to use. 

! Description: This routines sets up the I/0 port address for 

! the SCPI interface. For "HP 87xx'" instruments, 
: the address assigned to @Hp87xx = 800 otherwise, 
: 716. 

Disa pogiocokoiioi gia doi ania ICICI ASR AER Io a ACK a AA oR A aR a aa 


& indicates HP 87120/14€ only 8-149 


Exampie Programs 
Marker Limit Testing 


2140 SUB Iden_port 


2150 COM /Sys_state/ @Hp87xx ,Scode 
2160 ! 

2170 IF POS(SYSTEM$("SYSTEM ID") ,"HP 87")<>O THEN 
2180 ASSIGN GHp87xx TO 800 
2190 Scode=8 

2200 ELSE 

2210 ASSIGN @Hp87xx TO 716 
2220 Scode=7 

2230 END IF 

2240 ! 

2250 SUBEND !Iden_port 

2260 |! 


8-150 & indicates HP 8712€/14C only 


SRL Measurements (Option 100 only) 


MEAS_SRL This programs shows the effects of various connector 
modeling parameters on an SRL measurement. 


SRL_SRQ This program initiates an SRL cable scan and sets up 
the analyzer to send an SRQ interrupt when the scan is 
completed. 


69 indicates HP 8712C/14€ only 8-151 
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Exemple Programs 
SRL Measurements (Option 100 only} 


MEAS_SRL Example Program 


Filename: MEAS_SRL (option 100 only) 


This program is designed to show the effects of the various 
connector modeling on an SRL measurement. 


For this measurement: Users can change the following 
parameters. Each parameter can be adjusted either 
manually or can be determined automatically by the 
analyzer. 


' 

i 

i 

1 

1 

i 

i 

i 

i 

t 

! To measure SRL of a cable, connect a long cable terminated 
! with a load standard. (50 or 75 ohm). 

! The program steps through various settings. 

' 
t 
' 
! 
t 
t 
1 
1 
1 
' 


Cable Z ~ Cable impedance 

Cable Zstop - The max freq in which Z average is measrued 
Connector C - Connector Capacitance 

Connector Length - Connector Length 


After several values have been tried, the command is sent to 
measure the connector and automatically determine the optimum 
connector model values. 


i 

COM /Sys_state/ GHpS7xx,Scode 

$ Identify I/0 Port 

CALL Iden_port 

' 

OUTPUT GEp87xx;"SYST:PRES; *0PC?" 

ENTER GHp87xx; Ope 

' 

! Select the SRL measurement on channel 1 
QUTPUT OHp87xx;"SENS1:STAT ON; *WAI" 
OUTPUT @Hp87xx;"SENS1:FUNC SRL 1,0°;DET NBAN; *WAI" 
u 

1! Sweep Hold mode 


8-152 indicates HP 8712C/14C only 


1360 
1370 


1380 ! 


1390 
1400 
1410 
1420 
1430 
1440 
1450 


1460 ! 


1470 
1480 
1490 
1500 
1510 
1520 
1530 
1540 
1550 
1560 
1570 


1580 ! 


1590 
1600 
1610 
1620 
1630 
1640 
1650 
1660 
1670 
1680 
1690 
4700 
1710 
1720 
1730 
1740 
1750 
1760 


Example Programs 


SRL Measurements (Option 100 only) 


OUTPUT GHp87xx;"ABOR; : INITi:CONT OFF ; GPC?" 
ENTER @Hp87xx; Ope 

! 

! Take a sweep 

OUTPUT @Hp87xx;"ABOR;:INIT1:CONT OFF; :INIT1;+*WAI" 


BEEP 
! 


Clear_disp 

Disp_mess("SRL connector model test...") 
WAIT 5 

i 

CALL Meas_srl(0.,0,0.,2.10E+8) 


! Change srl parameters and re-measure 
Clear_disp 

Disp_mess("Setting default settings...") 
CALL Meas_sri(0.,0,0.,2.10E+8) 

WAIT 4 

! 

Clear_disp 

Disp_mess("Setting C = -1 pF...") 


CALL Meas_srl(0. ,-1.E-12,0.,2.10E+8) 
WAIT 4 

i 

Clear.disp 

Disp.mess("Setting L = 50 mm...") 


CALL Meas_sri(0.,-1.E-12,.050,2.10E+8) 
WAIT 4 

' 

Clear_disp 

Disp_mess("Setting manual Z to 76 Ohm...") 
CALL Meas_sri(76.,-1.E-12, .050,2.10E+8) 
WAIT 4 

I 

Clear_disp 

Disp_mess("Auto Z with z_cutoff = 1E9 Hz") 
CALL Meas_sr1l(0.,-1.E-12,.050,1.£+9) 

WAIT 4 

1 

Clear_disp 

Disp_mess("Optimize connector model...") 
CALL Meas_srl(-1.,-1-E-12,0.,2.1E+6) 


& indicates HP 8712C/14€ only 
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Example Programs 
SRL Measurements (Option 100 only} 


1770 WAIT 4 

1780 ! 

1790 Clear_disp 

1800 BEEP 

1810 END 

1820 ! 

1830 SUB Meas_sr1(REAL Z,REAL Cap,REAL Length,REAL Zstop) 
1840 coM /Sys.state/ @Hp87xx,Scode 

1850 DIM Msg$[80] 

1860 IF Z=0 THEN 

1870 WAIT 1 

1880 QUTPUT @Hp87xx;"SENS1:CORR:LENG:CONN "&VAL$ (Length) 
1890 QUTPUT @Hp87xx;"SENSi:CORR:CAP:CONN "&VAL$(Cap) 
1900 OUTPUT @Hp87xx;"SENS:FREQ:2ST "2VAL$(Zstop) 
1910 IF Z2>1. THEN 

1920 ! Set manual impedance mode 

1930 OUTPUT GHp87xx;"SENS1:FUNC:SRL:MODE MANUAL” 
1940 OUTPUT @Hp87xx;"SENS1:FUNC:SRL:IMP "&VAL$(Z) 
1950 ELSE 

1960 ! Automatically measure the impedance 

1970 GUTPUT @Hp87xx;"SENS1:FUNC:SRL:MODE AUTO" 
1980 END IF 

1990 ! Take a sweep 

2000 OUTPUT @Hp87xx;"ABOR; :INIT1:CONT OFF; :INIT1;*0PC?" 
2010 ENTER @Hp87xx; Opec 

2020 ELSE 

2030 ! Automatically determine the srl connector model 

2040 OUTPUT GHp87xx;"SENS1:CORR:MODEL:CONN;*OPC?" 
2050 ENTER @Hp87xx; Ope 

2060 END IF 

2070 BEEP 

2080 OUTPUT @Hp87xx;"SENS1:CORR: LENG: CONN?" 

2090 ENTER @Hp87xx;L 

2100 OUTPUT OHp87xx;"SENS1:CORR:CAP:CONN?" 

2110 ENTER @Hp87xx;C 


2120 | Read the impedance. 

2130 ! In AUTOMATIC_Z mode, the returned impedance is the measured 2. 
2140 ! In MANUAL Z mode, the returned impedance is the manually entered Z. 
2150 QUTPUT @Hp87xx;"SENS1:FUNC:SRL: INP?" 

2160 ENTER @Hp87xx; Zmeas 

2170 Zmeas=DROUND (Zmeas , 3) 
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Example Programs 
SRL Measurements (Option 100 only) 


Cnew=DROUND(C,3) 
Lnew=DROUND(L, 3) 
Msg$="C="£VAL$(Cnew)&" F, L="&VAL$(Lnew)&" m, Z="BVALS$ (Zmeas)&" 
Ohm'' 
Clear_disp 
Disp_mess (Msg$) 
SUBEND 
i 
SUB Disp.mess (Message$) 
coM /Sys_state/ @Hp87xx ,Scode 
OUTPUT @Hp87xx;"DISP:ANN:MESS:DATA ’"&Message$&"'?" 
SUBEND 
' 


SUB Clear.disp 


COM /Sys_state/ OHp87xx ,Scode 

DIM Command$ [40] 

OUTPUT GHp87xx;"DISP: ANN: MESS: CLE” 
SUBEND 
1 
soda gear ar OSG ISIS RIS RI aE ACR SICK AI a ok 1 a a oi a A AoE I 
! Iden.port: Identify io port to use. 
! Description: This routines sets up the I/0 port address for 
! the SCPI interface. For "HP 87xx" instruments, 
! the address assigned to @Hp87xx = 800 otherwise, 
: 716. 
sada a SSAA ORC IA aa TOI ICI Ia II A aC a I AK I aC a oI of af i A ao aR oO 
SUB Iden_port 


CoM /Sys_state/ @Hp87xx ,Scode 
i 

IF POS(SYSTEM$("SYSTEM ID") ,"HP 87")<>0 THEN 
ASSIGN @Hp87xx TO 800 
Scode=8 

ELSE 
ASSIGN @Hp87xx TQ 716 
Scode=7 

END IF 


SUBEND !Iden_port 
! 
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Example Programs 
SRL Measurements (Option 100 only) 


eed 


SRL_SRQ Example Program 


1000 !Filename: SRL_SRQ (option 100 only) 

1010 ! 

1020 | Description: 

1030 ! 

1040 ! This example program demonstrates how to initiate an SRL 
1050 ! cable scan. The instrument is set-up to send a 

1060 | SRQ interrupt when the scan has been completed. 

1070 ! 

1080 ! Connect the cable to be tested to the RF out port on the 
1090 ! analyzer. 

1100 ! 

1110 | Set an SRQ to occur when the SRL scan is complete. 

1120 ! 

1130 ! 


1140 COM /Sys_state/ GHp87xx,Scode 

1150 ! Identify I/0 Port 

1160 CALL Iden_port 

1170 ! 

1180 ! 

1190 ! Preset the instrument 

1200 OUTPUT @Hp87xx; "SYST: PRES ; *0PC?" 

1210 ENTER @Hp87xx; Ope 

1220 ! 

1230 ! Turn on SRL measurement 

1240 OUTPUT @Hp87xx;"SENS1:FUNC SRL 1,0°;DET NBAN;*OPC?" 
1250 ENTER @Hp87xx ; Ope 

1260 } 

1270 ! Clear status registers. 

1280 OUTPUT @Hp87xx;"*CLS" 

1290 ! 

1300 ! Clear the Service Request Enable register. 
1310 OUTPUT @Bp87xx;"*SRE 0" 

1320 ! 

1330 ! Clear the Standard Event Status Enable register. 
1340 OUTPUT @Hp87xx;"*ESE 0" 

1350 ! 
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1670 
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1730 ! 


1740 
1750 
1760 


Example Programs 
SRL Measurements (Option 100 only) 


{ Preset the remaining status registers. 
OUTPUT @Hp8?7xx;"STAT:PRES" 

! 

! Set operation status register to report 

! to the status byte on NEGATIVE transition 
! the srl bit. 

OUTPUT @Hp87xx;"STAT:OPER:ENAB 16" 

OUTPUT @Hp&7xx;"STAT:OPER:MEAS:PTR #HOOOO" 
OUTPUT OHp87xx;"STAT:OPER:MEAS:NTR #HFFFF" 
t 


! Set measuring status register to report to 

! operational status register on NEGATIVE transition 
! of the srl scan done bits. The NEGATIVE 

! transition needs to be detected because the 

! srl= bit 3 is set to 1 while the analyzer 

! is sweeping on channel 1 When the bit 

| goes back to 0, the srl scan is done. 

QCUTPUT GHp87xx;"STAT:OPER:MEAS:ENAB 4" 

1 


! Enable the operational status bit in the status 
! byte to generate an SRQ. 

OUTPUT @Hp87xx;"*SRE 128" 

1 


1 On an interrupt from HP-IB "Scode" (Interface 

! Select Code) SRQ bit (2), branch to the interrupt 
! service routine "Srq handler”. 

ON INTR Scode,2 GOSUB Srq_handler 


i " 

! Initialize flag indicating when srl scan done 
! to 0. Then loop continuously until the 

! interrupt is detected, and the interrupt 

! service routine acknowledges the 

! interrupt and sets the flag to 1. 

i 

Srl_done=0 

! Now enable the interrupt on SRQ (Service Request). 
ENABLE INTR Scode;2 

I 

! Initiate the SRL sweep 

OUTPUT @Hp87xx;'"'SENS1:FUNC:SRL:SCAN ; +*WAI" 


& indicates HP 8712C/14C only 8-157 


Example Programs 
SRL Measurements (Option 100 only) 
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2160 } 


DISP “Waiting for SRQ on srl scan done."; 
Loop 
DISP "5 
WAIT 1! Slow down dots 
EXIT IF Sri_done=i 
END LOcP 
t 
! Display desired completion message. 
DISP 
DISP "Got SRQ. SRL Scan!” 
STOP 
t 


Srq_handlier: ! Interrupt Service Routine 
i 


! Determine that the analyzer was actually 

1 the instrument that generated the 

! interrupt. 

Stb=SPOLL (@Hp87xx) 

i 

! Determine if the operation status register 

! caused the interrupt by looking at bit 7 

! of the result of the serial poll. 

IF BINAND(Stb,128)<>0 THEN 

i 

! Read the operational status event register. 
OUTPUT @Hp87xx;"STAT: OPER :EVEN?" 
ENTER @Hp87xx;Op_event 


! Determine if the srl status register 
! bit 4 is set. 
IF BINAND(Op_event,16)<>0 THEN 


! If so, then set flag indicating 
! srl scan done. 
Srl_dene=1 

END IF 
END IF 
RETURN 
END 
1 
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Example Programs 
SRL Measurements (Option 100 only} 


! FSAI ORO I OI Ea SE I kaa ca ae i ak RES ok akeaks 2k ak ic akc ok ae a ok ok kc oe a ai a 2 a co a ae os ak ok Cae 


Iden. port: Identify io port to use. 

Description: This routines sets up the 1/0 port address for 
the SCPI interface. For "HP 87xx" instruments, 
the address assigned to @Hp87xx = 800 otherwise, 
716. 


Digger da aa a EAS CE ISS RAC IK Aa ACC Ia AOR AOR A HOR EE A RR 
SUB Iden_port 


1 


COM /Sys_state/ QHp87xx,Scode 


IF POS(SYSTEM$ ("SYSTEM ID"), "HP 87')<>0 THEN 
ASSIGN @Hp&7xx TO 800 
Scode=8 
ELSE 
ASSIGN @Hp87xx TO 716 
Scode=7 
END IF 


SUBEND !Iden_port 
2360 ! 
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Fault Location Measurements (Option 100 only) 


FAULT This programs shows the effects of various fault location 
frequency modes on a cable measurement. 


USR_FLOC This program shows how to simplify fault location 
measurements by using the User BEGIN key. (You must 


have Option 1C2, IBASIC, to use the User BEG key.) 


8-160 SB indicates HP 8712C/14C only 


Example Programs 
Fault Location Measurements (Option 180 only) 


FAULT Example Program 


Filename: FAULT (Option 100 only) 


This program is designed to show the affects of the various 
fault location frequency modes on a cable measurement. 


Connect a 50 m. (150ft) cable to the RF out of the analyzer. 
(if available). 


The program steps through various settings. 


! 

i 

i 

i 

i 

] 

1 

1 

4 

1 

! Set Feet/Meters 
! Start Distance O meters 
! Stop Distance 100 meters 
! Low Pass mode 

! Band Pass mode CF 

! Band Pass mode CF 

! Low Pass mode 

! Cable Loss 

! Cable Velocity Factor 
1 

! 

t 

5 

! 

i 


600 MHz 
900 MHz 


uo 


The commands which cause changes to frequency settings will 
cause the analyzer to automatically display a caution message 
to verify Cable Loss and Velocity Factor. 


COM /Sys_state/ @Hp87xx,Scode 

! Identify I/O Port 

CALL Iden_port 

t 

! Preset the analyzer 

OUTPUT @Hp87xx;"SYST:PRES; ¥*0PC?" 

ENTER @Hp87xx ; Ope 

! 

! Enable fault location measurment on channel 1 
QUTPUT @Hp87xx;"SENS1:STAT ON; *WAI" 

OUTPUT @Hp87xx;"SENS1:FUNC ?FLOC 1,0’;DET NBAN; *OPC?" 
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ENTER GHp87xx; Ope 


Example Programs 


Fault Location Measurements (Option 190 only) 


WAIT 2 


Autoscale the fault measurment 
QUTPUT GHp87xx;"DISP:WIND1:TRAC:Y:AUTO ONCE" 
t ‘ 


Clear_disp 

Disp_mess("Fault Location Demo...") 

WAIT 3 

t 

! Reset the cable loss and velocity factor 
OUTPUT @Hp87xx;"SENS1:CORR:LOSS:COAK .0" 


QUIPUT GHp87xx;"SENS1:CORR:RVEL:COAX 1." 
' 


Clear.disp 
Disp_mess ("Setting units to Meters") 
i 


! Set the units to read in METERS 

OUTPUT @Hp87xx;"SENS:DIST:UNIT MET" 

!QUTPUT @Hp87xx;"SENS:DIST:UNIT FEET’ ! Display units in feet 
WAIT & 


Clear_disp 
Disp_mess ("Setting Start and Stop Distance") 
t 


! Set the start distance to 0. 
OUTPUT GHp87xx;"SENS1:DIST:STAR 0; *WAI” 
iy 


! Set the stop distance to 100. 
OUTPUT @Hp&7xx;"SENS1:DIST:STOP 100; *WAI" 
4 


! Send an operation complete query to ensure that 
! all overlapped commands have been executed. 
OUTPUT @Hp87xx;"*0PCT" 

t 


! Wait for the reply. 
ENTER @Hp87xx ; Ope 
i 


WAIT 10 
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Example Programs 
Fault Location Measurements (Option 100 only) 


! Change to Band pass mode 

OUTPUT @Hp87xx;"SENS:FREQ:MODE CENT; *WAI" 

i 

Clear disp 

Disp_mess("Setting CF to 600 MHz. Band Pass") 
! 

! Set Center Frequency to 600 MHz 

OUTPUT @Hp87xx;"SENS1:FREQ:CENT 600000000 HZ;*WAI" 
WAIT 10 

! 

Clear_disp 

Disp_mess("Setting CF to 900 MHz. Band Pass") 
' 

! Set Center Frequency to 900 MHz 

OUTPUT @Hp87xx;"SENS1:FREQ:CENT 900000000 HZ; *WAI" 
WAIT 10 

t 

Clear disp 

Disp_mess("Return to Low Pass Mode") 

! 

! Return to Low Pass Mode 


OUTPUT @Hp87xx;"SENS:FREQ:MODE LOWP; WAI" 
WAIT 10 

! 

Clear.disp 

Disp_mess("Set Cable Loss to 10dB/100 ft") 


OUTPUT @Hp87xx;"SENS1:CORR:LOSS:COAX 10.0" 
WAIT 10 

t 

Clear_disp 

Disp.mess("Set Velocity factor to 8") 
OUTPUT @Hp87xx;"SENS1:CORR:RVEL:COAX .8" 
WAIT 10 

! 

Clear_disp 

Disp_mess("Set Cable Loss=0., VF=1.0") 
OUTPUT @Hp87xx ; "SENS1: CORR: LOSS : COAX 0" 
OUTPUT @Hp87xx;"SENS1:CORR:RVEL:COAX 1." 
WAIT 10 

! 


DISP "Done" 
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Example Programs 
Fault Location Measurements (Gption 100 enly) 


BEEP 
END 
! 
SUB Disp_mess (Message$) 
COM /Sys_state/ @Hp87xx,Scode 
OUTPUT @Hp87xx;"DISP:ANN:MESS:DATA ’"&Message$&"'?" 
SUBEND 


SUB Clear_disp 

COM /Sys_state/ @Hp87xx,Scode 

DIM Command$ [40] 

QUTPUT GHp87xx;"DISP: ANN:MESS : CLE" 
SUBEND 
i 
Diggin doko doboncijiack daaiaioiaiaici ick asic ae dei joing ack tokoleak kk ok a ae ok a aa 
1 Iden.port: Identify io port to use. 
! Description: This routines sets up the I/O port address for 
i the SCPI interface. For "HP 87xx" instruments, 
! the address assigned to @Hp87xx = 800 otherwise, 
! 716. 
Ingieiokiegor iol dicieiceiiciioioooidak ici a dea aibk Fos I aC I IGE ICICI I A IK a aa 
SUB Iden_port 


COM /Sys_state/ @Hp87xx,Scode 
i 

IF POS(SYSTEM$("SYSTEM ID") ,"HP 87")<>0 THEN 
ASSIGN @Hp87xx TQ 800 
Scode=8 

ELSE 
ASSIGN @Hp87xx TO 716 
Scode=7 

END IF 


t 
SUBEND !Iden_port 
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Example Programs 
Fault Location Measurements (Option 100 anly) 


USR.FLOC Example Program 


De ae ie a tt me ee fe A Se er i 

{ 

! BASIC program: USR.FLOC 

I 

! Fault Location measurements require option 100. 

! User BEGIN requires option 1C2, IBASIC. 

t 

£ 

! This is an example user BEGIN program for fault location. 

! 

! Lead this program into the analyzer. Then press [BEGIN] 

PEOE a I 

! [User BEGIN ON]. 

i 

! The following line is required. DO NOT REMOVE! 

User_begin: ASSIGN @Rina TO 800 !(User Begin] Program 

ASSIGN @Hp&712 TO 800 

t 

! To Modify: 

! Use [IBASIC] [EDIT] or [IBASIC] [Key Record] 

7 

! 

! Declare storage for variables. 
DIM Name$[60] ,Str1$[60] ,str2$ [60] ,Str3$ [60] 

t 

! Clear the softkey labels 
OUTPUT @Rfna;"DISP:MENU2:KEY8 ??;*WAI" 

i 

! Re-define softkey labels here. 
QUIPUT @Rfna;"DISP:MENU2:KEY1 ’Test End of Cable’ ;*WAI" 
QUTPUT @Rfna;"DISP:MENU2:KEY2 ’*?;*WAI" 
OUTPUT @Rfna;"DISP:MENU2:KEY3 ’Mkr -> Max? ;+*WAI" 
QUIPUT @Rfna;"DISP:MENU2:KEY4 *Next Peak Left’; *WAI" 
OUTPUT @Rfna;"DISP:MENU2:KEY5 ’Next Peak Right’; *WAI" 
OUTPUT @Rfna;"DISP:MENU2:KEY6 *Zoom on Marker’ ;*WAL" 
QUIPUT @Rfna;"DISP:MENU2:KEY7 **?;*WAI" 

' 
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Example Programs 
Fault Location Measurements (Option 100 only) 


!The following 2 lines are required. DO NOT REMOVE! 
User,,pause: PAUSE 
GOTO User_pause 
' 
User_keyl: ! Example Set Stop Distance to 1100ft 
OUTPUT @Hp8712;"SENS1:STAT ON; *Wal" 
OUTPUT @Hp8712;"SENS1:FUNC °FLOC 1,07;DET NBAN; ¥WAI" 
OUTPUT @Hp8712;"SENS1:DIST:STOP 1100; *opc?” 
ENTER @Hp8712;0pe 
OUTPUT @Hp8712;"SENS1:CORR:RVEL:COAX 0.89" 
OUTPUT @Hp8712; "DISP:WIND1 :TRAC:Y:AUTO ONCE" 
GOTO User_pause 
i] 
User _key2: ! Define softkey 2 here. 
GOSUB Message ! Remove this line 
GOTO User_pause 
t 
User_kKey3: ! Example Marker Function 
GUTPUT @Rfna;"CALC1:MARK1 ON" 
OUTPUT @Rfna;"CALC1:MARK:FUNC MAX" 
GOTO User_pause 
{ 
User_key4: ! Define softkey 6 here. 
OUTPUT @Rfna;"CALC1:MARK1 ON" 
OUTPUT @Hp8712;"CALC1:MARK :MAX:LEFT" 
GOTO User_pause 
E 
User_key5: ! Define softkey 5 here. 
OUTPUT @Hp8712;"CALC1:MARKi ON" 
OUTPUT G@Hp8712;"CALC1 :MARK :MAX : RIGHT" 
GOTO User_pause 
i 
User_key6: ! Zoom on Cable 
OUTPUT @Hp8712;"SENS1:STAT ON; *WAI" 
OUTPUT @Hp8712;"SENS1:FUNC *FLOC 1,0°;DET NBAN; 4WAI" 
OUTPUT @Hp8712;"calci:marki:x?" 
ENTER @Hp8712;Distance 
New_start=Distance-20 
IF (New start<0) THEN New start=0 
OUTPUT @Hp8712;"sensi:dist:start "SVAL$ (New_start) 
OUTPUT @Hp8712;"sensi:dist:stop "eVAL$ (Distance+20) 
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Example Programs 
Fault Location Measurements (Option 100 only} 


OUTPUT @Hp8712;"*opc?” 
ENTER @Hp8712;Opc 
GOTO User_pause 
! 

User key7: ! Define softkey 7 here. 
GOSUB Message ! Remove this line. 
GOTO User_pause 
' 

Message: ! 
Strig$="This key is programmable." 
Str2¢="To modify, select" 
Str3$="(System Options], [IBASIC], [Edit] ." 
OUTPUT @Rfna;"DISP:ANN:MESS 
"eStr1i$ZCHR$ (10) eStr2$eCHR$(10)eStr3$e"? , MEDIUM" 
RETURN 


END 
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Multiport Test Set Measurements 


PORT_SEL Using graphics to show internal connections 
of the HP 87075C when different ports are 
selected. 

TSET_CAL Recalling “TSET_CAL.CAL” and performing 


a test set calibration. 
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Exampie Programs 
Multiport Test Set Measurements 


PORT_SELection Example Program 


This program displays the internal connections of the HP 87075C multiport 
test set when different ports are selected. The internal connections of the 
multiport test set are drawn on the IBASIC display. Whenever the user 
selects a different port on the multiport test set, the program will redraw the 
internal connections. 


This program also demonstrates how to use IBASIC to draw a fairly 
complicated drawing on the network analyzer. 


NOTE 


This program only works with the HP 87075C multiport test set and IBASIC, Option 1C2. 


Filename: PORT.SEL, 87075 Port Selection Example 


Description: 
This program demonstrate how the internal connections of 87075 
are carried out when the different ports for Reflection and 
Transmission are selected. It intends to show as an example 
of how to select the 87075 ports and how to draw draw graphics 
on the IBASIC window. 


NOTE: This program works properly ONLY 
when option 1C2, IBASIC, has been installed. 
Modify to use DISP:WIND";VAL$(Wind);" if no IBASIC option. 


! Common Variables 
COM /Sys_state/ @Hp87xx,Scode ,Keycode,Wind 
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Exampie Programs 
Multiport Test Set Measurements 


1180 COM /Hp8711_coord/ 
Orig_x_8711,0rig_y8711,Ref1_x.8711,Refl_y_8711,Tran_x_8711, 
Tran_y_8711 

1190 COM /Hp87075_coord/ 

Orig. x_87075 ,Orig_y_87075 ,Refl_x_87075 ,Refl_y_87075 ,Tran.x_87075, 
Tran_y_87075 

1200 COM /Hp8707S_ports/ Port.x(1:12) ,Port_y(1:12) 

1210 COM /Color/ Erase ,Bright ,Dim 

1220 COM /Sys_var/ Refl_port ,Tran.port 


1240 ! Identify I/0 Port 
1250 CALL Iden_port 
1260 ! 
1270 OUTPUT @Hp87xx;"SYST:PRES; *WAI" ! Preset the system 
1280 CALL Setup_constant 
i 


1300 ! Allocate an IBASIC display partition to show the graphics 

1310 ! 

1320 OUTPUT @Hp87xx;"CONT1:MULT:STATE ON" ! Make sure 87075 mode is 
enabled 

1330 OUTPUT @Hp87xx;"DISP:FORM SING" 

1340 OUTPUT @Hp87xx;"DISP:PROG:MODE FULL" 

1350 OUTPUT @Hp87xx;"DISP:WIND" ; VAL$ (Wind) ;":GRAP:SCAL 0,1023,0,383" 
£ 


1370 ! Clear the IBASIC display partition. 
1380 OUTPUT @Hp87xx;"DISP:WIND" ; VAL$ (Wind) ;":GRAP:CLE" 
' 


1400 CALL Draw_analyzer 

1410 CALL Draw.87075 

1420 ! 

1430 ! Connect HP8711 to HP87075 for the Refl and Tran ports 

1440 CALL Connect (Ref1l_x_8711,Refl_y_8711,Ref1_x_87075 ,Refl_y_87075 ,Bright) 
1450 CALL Connect (Tran_x_8711,Tran_y_8711,Tran_x_87075 ,Tran_y_87075 ,Bright) 
1460 CALL Set_ref1(1) 

1470 CALL Set_tran(2) 

1480 ! 

1490 ! Infinite loop to wait for softkey requests 

1500 Do_loop:! 

1510 GOSUB Setup.srq 

1520 } 
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Example Programs 
Multipart Test Set Measurements 


GOTO Do_loop 

STOP 

' 

t ee ee ie ee te tr ee mH 
! Setup interrupts 

' 

Setup_srq:! 

! If using an external controller... 

1 

! Initialize flag for checking on keyboard 

{ interrupts. 

Keycode=-1 

I 

! Label softkey 1. 

QUTPUT GHp87xx; “DISP: MENU: KEY1 Reflection to Port #’" 


OUTPUT @Hp87xx; "DISP: MENU: KEY2 ‘Transmissn to Port #’" 
OUTPUT @Hp87xx;"DISP:MENU:KEYS ’Done’" 

i FS 

! Clear the status register and event status 

! register. 

OUTPUT GHp87xx;"*CLS;*ESE 0" 

! Preset the other status registers. 

! Enable the Device Status register to report 
! to the Status Byte on positive transition 

! of bit O (key press). Enable the Status 

! Byte to generate an interrupt when the 

! Device Status register’s summary bit 

! changes. 

OUTPUT @Hp87xx;"STAT:PRES;DEV:ENAB 1;*SRE 4" 

t 

! Clear the key queue to ensure that previous 
! key presses do not generate an interrupt. 
OUTPUT GHp87xx; "SYST: KEY: QUE:CLE" 

\ 

! Set up and enable the interrupt on the HP~IB 
! when a service request is received. 

ON INTR Scode,& RECOVER Srq 

ENABLE INTR Scode;2 

Suspend: !WAIT 5 ! Use WAIT ’n’ to suspend IBASIC 
GOTO Suspend 


t 
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Multiport Test Set Measurements 


! Interrupt Handler 
1 


Srq: i 
1 


! Do a serial poll to find out if analyzer generated the 
! interrupt. 
Stb=SPOLL (@Hp87xx) 
i 
! Determine if the Device Status register’s summary 
l bit (bit 2 of the Status Byte) has been set. 
IF BINAND(Stb,4)<>0 THEN 
I 
! If so, then get the Device Status Register contents. 

OUTPUT @Hp87xx;"STAT:DEV: EVEN?" 

ENTER @Hp87xx;Dev_event 
3 
$ Check for key press... 

IF BINAND(Dev_event,1)<>0 THEN 
! If so, then determine which key. 

OUTPUT @Hp87xx; “SYST: KEY?" 
ENTER @Hp87xx ;Keycode 

END IF 
END IF 
t 
! Reenable the interrupt in case wrong key 
! was pressed. 
CALL Softkey_handler 
ENABLE INTR Scode 
' 
RETURN 
END 


Subroutines 


Setup_constant 
Setup all global constants 
SUB Setup_constant 
COM /Sys_state/ @Hp87xx ,Scode ,Keycode,Wind 


' 
t 
1 
i 
' 
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Example Programs 
Muiltipert Test Set Measurements 


2350 COM /Hp8711_coord/ 
Orig..x.8711,Orig_y_8711,Refl_.x_871i1 »Refl_y_8714,Tran_x_8711, 
Tran_y_8711 

2360 COM /Hp87075.coord/ 
Orig_x_87075 ,Orig.y_87075 »Refl_x_87075 ,Refl_y.87075 ,Tran_x_87075, 


Tran y_87075 
2370 COM /Hp87075_ports/ Port_x(1:12) ,Port_y(1:12) 
2380 COM /Color/ Erase ,Bright ,Dim 
2390 coM /Sys.var/ Refl_port ,Tran_port 
2400 Orig_x_8711=30 
2410 Orig.y.8711=170 
2420 Ref1_x_8711=Orig.x_8711+300 
2430 Refl_y_8711*O0rig_y_8711+20 
2440° Tran_x._8711=O0rig_x_8711+410 
2460 Tran_y_8711=0rig_y_8711+20 
2460 Orig.x_87075=30 
2470 Orig_y.87075=30 
2480 Ref1l_x_87075=0rig_x_87075+300 
2490 Refly..87075=Orig_y_87075+80 
2500 Tran,.x_87075=0rig_x_87075+410 
2510 Tran_y.87075=0rig_y_87075+80 
2520 FOR I=1 TO 11 STEP 2 
2530 Port_x(I)=0rig_x_87075+100+( ( (1-1) /2)*60) 
2540 Port_y(I)=0rig_y_87075+45 
2550 NEXT I 
2560 FOR I=2 TO 12 STEP 2 
2570 Port_x(I)=0rig.x_87075+130+(( (1-2) /2)*60) 
2580 Port.y(1)=0rig_y_87075+25 
2590 NEXT I 
2600 Erase=0 
2610 Bright=1 
2620 Dim=2 
2630 Wind=10 
2640 Refl_port=0 
2650 Tran_port=0 
2660 SUBEND 
2670 ! 
2680: leaemsHaSs tee eseseotes Se Spee a eS ee nas eecro cS temesesesess Soon SeossS 
2690 ! Drawing routines 
2700 } 


2710 ! Draw analyzer 


& indicates HP 8712C/14€ only 8-LT: 
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2720 | Draw an HP8711 Analyzer on the Ibasic window 

2730 SUB Draw_analyzer 

2740 CoM /Sys.state/ @Hp87xx ,Scode,Keycode, Wind 

2750 COM /Hp8711_coord/ 
Orig..x_8711,Orig.y_8711 »Refl_x_8711,Refl_y_8711,Tran_x_8711, 
Tran_y.8711 

2760 ! Select the bright "pen" and bold font. 

2770 OUTPUT @Hp87xx;"DISP: WIND" ; VAL$(Wind) ;":GRAP:COL 1;LAB:FONT BOLD" 

2780 ! 

2790 ! Draw a label reading "HP 8711" at 30 pixels 

2800 | to the right and 270 pixels above the origin. 

2810 ! The origin is the lower left corner of the 

2820 ! current graphics window 

2830 OUTPUT @Hp87xx;"DISP: WIND" ; VAL$ (Wind) ;":GRAP : MOVE 
"5 O0rig_x.8711;",";0rig_y.8711+120+10;";LAB ’HP 8711C7" 

2840 ! 

2850 ! Draw a box to represent the analyzer. 

2860 OUTPUT @Hp87xx;"DISP: WIND" ; VAL$(Hind) ;":GRAP:MOVE 
"sOrig.x.8711;",";Orig.y_8711 

2870 OUTPUT @Hp87xx;"DISP: WIND" ; VAL$(Wind) ;":GRAP:RECT 480,120" 

2880 OUTPUT @Hp87xx;"DISP:WIND"; VAL$(Wind) ;":GRAP: MOVE 
"Orig.x_8711420;",";0rig_y_8711+10 

2890 OUTPUT @Hp87xx;"DISP: WIND" ; VAL$(Wind) ;":GRAP:RECT 210,100" 

2900 OUTPUT @Hp87xx; "DISP:WIND" ; VAL$(Wind) ;":GRAP:MOVE 
";Refl_x_8711;",";Refl_y_8741 

2910 OUTPUT @Hp87xx;"DISP: WIND"; VAL$(Wind) ;":GRAP:CIRC 4" 

2920 OUTPUT @Hp87xx;"DISP: WIND" ; VAL$ (Wind) ;":GRAP : MOVE 
"5 Tran_x_8711;",";Tran_y_8711 

2930 OUTPUT @Hp87xx;"DISP: WIND"; VAL$(Wind) ;":GRAP:CIRC 4" 

2940 OUTPUT @Hp87xx;"DISP: WIND"; VAL$(Wind) ;":GRAP:COL 1;LAB:FONT SLAN" 

2950 CUTPUT @Hp87xx;"DISP: WIND"; VAL$ (Wind) ;":GRAP: MOVE 
";Refl_x_8711-40;",";Refl_y.8711+10 

2960 OUTPUT @Hp87xx;"DISP:WIND"; VAL$(Wind) ;":GRAP:LAB ?RF QUT?" 

2970 OUTPUT @Hp87xx;"DISP:WIND"; VAL$(Wind) ;":GRAP:COL 1;LAB:FONT SLAN" 

2980 OUTPUT @Hp87xx;"DISP: WIND"; VAL$ (Wind) ;":GRAP : MOVE 
"3 Tran_x_8711-20;",";Tran_y_8711+10 

2990 OUTPUT @Hp87xx;"DISP: WIND" ; VAL$(Wind);":GRAP:LAB ’RF IN?" 

3000 SUBEND 

3010 ! 

3020 ! Draw_87075 

3030 ! Draw an 87075 Multiport test set with twelve port setups 


8-174 
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3040 
3050 
3060 


3070 
3080 
3090 
3100 
3110 
3120 
3130 
3140 
3150 
3160 


3170 
3180 


3190 
3200 


3210 
3220 


3230 
3240 
3250 


3260 
3270 
3280 


3290 
3300 
3310 


3320 
3330 


3340 


SUB Draw_87075 
COM /Sys_state/ @Hp87xx,Scode ,Keycode,Wind 


COM /Hp87075_coord/ 


Example Programs 


Multiport Test Set Measurements 


Orig_x_87075 ,Orig_y_87075 ,Ref1_x_87075,Refl_y_87075,Tran_x_87075, 


Tran_y..87075 


COM /Hp87075_ports/ Port.x(1:12) ,Port.y (1:12) 
Select the bright “pen" and bold font. 
OUTPUT @Hp87xx;"DISP:WIND" ; VAL$ (Wind) ;":GRAP:COL 1;LAB:FONT BOLD" 


Draw a label reading "HP 87075" at 30 pixels 
to the right and 110 pixels above the origin. 
The origin is the lower left corner of the 


current graphics window 


OUTPUT @Hp87xx;"DISP:WIND" ; VAL$ (Wind) ;":GRAP :MOVE 
";Orig_x_87075;",";0rig_y.87075+100+10;"; LAB 7HP 87075°" 


OUTPUT @Hp87xx;"DISP : WIND" ; VAL$ (Wind) ;":GRAP: 
";Orig_x_87075;",";Orig_y_87075 

OUTPUT @Hp87xx;"DISP:WIND" ; VAL$ (Wind) ;":GRAP 
OUTPUT @Hp87xx;"DISP :WIND" ; VAL$ (Wind) ;":GRAP 
" SRef1_x_87075;",";Refl_y_87075 

OUTPUT @Hp87xx;"DISP :WIND" ; VAL$ (Wind) ;":GRAP 
OUTPUT @Hp87xx;"DISP :WIND" ; VAL$ (Wind) ;":GRAP 
"sTran_x_87075;",";Tran_y_87075 

QUIPUT ©Hp87xx;"DISP :WIND" ; VAL$ (Wind) ;":GRAP: 
OUTPUT @Hp87xx;"DISP:WIND" ; VAL$ (Wind) ;":GRAP 


OUTPUT @Hp87xx;"DISP :WIND" ; VAL$ (Wind) ;":GRAP 
" -Refl_x_87075-40 ;",";Refl_y_87075+10 

OUTPUT GHp87xx;"DISP :WIND" ; VAL$ (Wind) ;":GRAP 
QUIPUT @Hp87xx;"DISP:WIND" ; VAL$ (Wind) ;":GRAP: 


OUTPUT GHp87xx;"DISP :WIND" ; VAL$ (Wind) ;":GRAP 
©; Tran_x_87075-20;",";Tran_y_87075+10 
OUTPUT CHp87xx;"DISP :WIND" ; VAL$ (Wind) ;":GRAP: 


FOR I=1 TO 12 


MOVE 


:RECT 480,110" 
:MOVE 


:CIRC 4" 
:MOVE 


cIRC 4" 


:COL 1;LAB:FONT SLAN" 
:MOVE 


:LAB ’REFL?" 


COL 1;LAB:FONT SLAN" 


:MOVE 


LAB ’ TRAN?" 


OUTPUT @Hp87xx ; "DISP: WIND" ; VAL$(Wind) ;":GRAP : MOVE 
"sPort_x(I);",";Port_y (I) 
OUTPUT @Hp87xx ;"DISP: WIND" ; VAL$ (Wind) ;":GRAP :CIRC 4" 


OUTPUT @Hp87xx;"DISP: WIND" ; VAL$(Wind) 5" 
SLAN" 
OUTPUT GRp87xx;"DISP: WIND" ; VAL$ (Wind) ;" 


:GRAP:COL 1;LAB:FONT 


:GRAP : MOVE 
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"Port x(I)-8;",";Port_y(1)-18 


3350 OUTPUT CHp87xx;"DISP:WIND" ; VAL$ (Wind) ;":GRAP:LAB ? " VAL$(I) ; 17" 
3360 NEXT I 

3370 SUBEND 

3380 ! 

BBQO bw nn nnn nn te rn a me am nn Oe 
3400 ! Connection routines 


t 

3410 ! 

3420 ! Connect 
t 
t 


3430 ! Connect (xl,y1) to (x2,y2) with the specied color ’Col’ 

3440 ! If Color = 0, it will be an erase command instead. 

3450 SUB Connect (Ki,Yi,X2,¥2,Col) 

3460 COM /Sys_state/ @Hp87xx,Scode,Keycode,Wind 

3470 OUTPUT OHp87xx;"DISP: WIND" ; VALS (Wind) ;":GRAP: COL "3Col 

3480 OUTPUT @Hp87xx; "DISP: WIND" ; VAL$(Wind) ;":GRAP: MOVE ey GPs ay 

3490 QUTPUT @Hp87xx; "DISP : WIND" ; VAL$ (Wind) ;":GRAP: DRAW "5X2;","5¥2 

3500 SUBEND 

3510 ! 

3520 ! Connect.refl 

3530 ! Connect the reflection port to the specified port index I with 

3540 ! color *Col’. Use Col=0 to erase the connection. This routine 

3550 | uses the port coordinates from Port.x(1:12) and Port_y (1:12) 

3560 SUB Connect_ref1(1,Col) 

3570 COM /Sys_state/ @Hp87xx ,Scode,Keycode, Wind 

3580 COM /Hp871i1_coord/ 
Orig.x_8711,0rig.y_8711,Ref1_x_8711,Refl_y_8711,Tran_x_8711, 
Tran_y..87i1 

3590 COM /Hp87075_coord/ 
Orig_x_87075, Orig. y_87075 ,Refl_x_87075 ,Refl_y_87075 ,Tran_x_87075, 
Tran_y_87075 

3600 COM /Bp8707S_ports/ Port_x(1:12) ,Port_y(1:12) 

3610 ! 

3620 Temp_y=Refl_y_87075~10 

3630 Connect (Refl_x_87075 ,Refl_y_87075, Ref1_x_87075,Temp_y,Col) 

3640 Connect (Ref1_x_87075 ,Temp_y ,Port.x(I) ,Temp_y,Col) 

3650 Connect (Port_x(I) ,Temp_y,Port_x(I) ,Port_y (I) ,Col) 

3660 SUBEND 

3670 ! 

3680 


1 
3690 ! Connect_tran 
3700 ! Connect the transmission port to the specified port index I with 
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3710 
3720 
3730 
3740 
3750 


3760 


3770 
3780 
3790 
3800 
3810 
3820 
3830 
3840 
3850 
3860 
3870 
3880 
3890 
3900 
3910 
3920 
3930 
3940 
3950 
3960 


3970 


3980 
3990 
4000 
4010 
4020 
4030 


SUB 


Example Programs 
Multiport Test Set Measurements 


color ’Col’. Use Col=0 to erase the connection. This routine 
uses the port coordinates from Port_x(1:12) and Port_y(1:12) 
Connect_tran(I,Col) 

COM /Sys_state/ @Hp87xx,Scode ,Keycode, Wind 

COM /Hp8711_coord/ 
Orig.x.8711,0rig_y_8711,Ref1_x_8711,Refl_y_8711,Tran.x_8711, 
Tran_y_8711 

COM /Hp87075_coord/ 

Orig.x_87075 ,Orig.y.87075 ,Ref1_x_87075 ,Refl_y_87075,Tran_x_87075, 
Tran_y.87075 

COM /Hp87075_ports/ Port_x(1:12) ,Port.y (1:12) 


Temp_y=Refl_y_87075~20 

Connect (Tran_x_87075 ,Tran_y_87075 , Tran_x_87075 ,Temp_y,Col) 
Connect (Tran_x_87075 ,Temp.y,Port.x(I) ,Temp_y ,Col) 

Connect (Port..x(I) ,Temp.y,Port_x(I) ,Port.y(I) ,Col) 


SUBEND 


Softkey handle routines 


Select _refl 


Select the reflection port by requesting a valid port number from 
the user. The input port number is used to select the reflection 
port accordingly. This routine will also update the drawing 
connections on the [basic window. Any invalid number will be 
ignored . 

Select_refl 

COM /Sys_state/ OHp87xx ,Scode , Keycode, Wind 

COM /Hp8711_coord/ 
Orig.x.8711,0rig_y_8711,Ref1_x_8711,Refl_y_8711,Tran_x_8711, 
Tran_y_8741 

COM /Hp87075_coord/ 

Orig_x_87075 ,Orig. y..87075 , Ref 1_x_87075 ,Ref1_y_87075,Tran_x_87075, 
Tran y.87075 

COM /Color/ Erase Bright ,Dim 

coM /Sys.var/ Refl_port ,Tran_port 


OUIPUT GHp87xx;"DISP: WIND" ; VAL$ (Wind) ;":GRAP:COL ";Bright 
OUTPUT @Hp87xx;"*0PC?" 
ENTER @Hp87xx; Ope 
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4040 
4050 
4060 
4070 
4080 
4090 
4100 
4110 
4120 
4130 
4140 


4150 


4160 
4170 
4180 
4190 
4200 
4210 
4220 
4230 
4240 
4250 
4260 
4270 
4280 
4290 
4300 
4310 
4320 
4330 
4340 
4350 
4360 
4370 


4380 


Example Programs 
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INPUT "Connect Reflection to Port #:",P 
CALL Set_ref1(P) 


SUBEND 


! 
! 
! Set_refl 
! 
! 


SUB 


Update the currently selected reflection port with the specified 
port °P’. Update the connection drawing on the Ibasic window. 
Set_refl(P) 

COM /Sys_state/ @Hp87xx,Scode,Keycode,Wind 

COM /Hp8711_coord/ 
Orig_x_8711,0rig_y.8711,Ref1_x_8711,Refl_y_8711,Tran_x_8711, 
Tran_y_8711 

COM /Hp87075_coord/ 

Orig_x_87075,0rig_y_87075 ,Refl_x_87075 ,Ref1_y.87075 ,Tran_x_87075, 
Tran. y.87075 

COM /Color/ Erase,Bright ,Dim 

COM /Sys_var/ Refl_port,Tran.port 


OUTPUT @Hp87xx; "ROUT: REFL:PATH:DEFine:PORT ";P 
OUTPUT @Hp87xx; "ROUT: REFL:PATH:DEFine:PORT?" 
ENTER @Hp87xx ;New_refl 

OUTPUT @Hp87xx; "ROUT: TRAN: PATH:DEFine: PORT?" 
ENTER @Hp87xx;New_tran 

Update_ports(New_refl ,New_tran) 


SUBEND 


SUB 


Select_tran 


Select the transmission port by requesting a valid port number from 
the user. The input port number is used to select the transmission 
port accordingly. This routine will also update the drawing 
connections on the Ibasic window. Any invalid number will be 
ignored. 

Select_tran 

COM /Sys_state/ @Hp87xx,Scode, Keycode, Wind 

COM /Hp8711_coord/ 
Orig_x_8711,0rig_y_8711,Ref1_x_8711,Refl_y_8711,Tran_x_8711, 
Tran_y.8711 

COM /Hp87075_coord/ 
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4390 
4400 
4410 
4420 
4430 
4440 
4450 
4460 
4470 
4480 
4490 
4500 
4510 
4520 
4530 
4540 
4550 


4560 


4570 
4580 
4590 
4600 
4610 
4620 
4630 
4640 
4650 
4660 
4670 
4680 
4690 


A700 ! 


4710 
4720 
4730 


Example Programs 
Multipart Test Set Measurements 


rig_x_87075 ,Orig_y.87075,Refl_x_87075 ,Refl_y_87075,Tran_x_87075, 
Tran_y.87075 


COM /Color/ Erase Bright ,Dim 
com /Sys.var/ Refl_port,Tran_port 
i 
QUIPUT @Hp87xx;"DISP : WIND" ; VAL$ (Wind) ;":GRAP:COL ";Bright 
OUTPUT @Hp87xx;"*0PC?" 
ENTER GHp87xx ; Ope 
INPUT "Connect Transmission to Port #:",P 
CALL Set_tran(P) 
SUBEND 
I 
t 
! Set_tran 
: Update the currently selected transmission port with the specified 
! port ’P’. Update the connection drawing on the Ibasic window. 
SUB Set_tran(P) 


COM /Sys_state/ @Hp87xx ,Scode,Keycode,Wind 

COM /Hp8711_.coord/ 
Orig_x_8711,0rig.y.8711,Refl_x_8711,Refl_y_8711,Tran_x_8711, 
Tran_y_8711 

COM /Hp87075_coord/ 

Orig_x_87075 , Orig. y_.87075, Refl_x_87075,Refl_y_87075 ,Tran_x_87075, 
Tran_y_87075 

COM /Color/ Erase, Bright ,Dim 

coM /Sys_var/ Refl_port ,Tran_port 


OUTPUT @Hp87xx; "ROUT: TRAN:PATH:DEFine:PORT ";P 
OUTPUT @Hp87xx; "ROUT: TRAN :PATH: DEF ine:PORT?" 
ENTER GHp87xx;New_tran 

OUTPUT @Hp87xx; "ROUT :REFL: PATH: DEFine:PORT?" 
ENTER @Hp87xx;New_refl 

Update_ports (New. refl,New_tran) 


SUBEND 


! Update_ports 


Update the currently selected ports. Erase old connections. 
Draw new connections. 


SUB Update_ports(Refl, Tran) 


coM /Color/ Erase,Bright .Dim 
coM /Sys.var/ Refl_port ,Tran_port 
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4740 IF Tran_port=0 THEN 

4750 Tran, port=Tran 

4760 ELSE 

4770 IF Tran<>Tran_port THEN 

4780 Connect.tran (Tran port »Erase) 
4730 Tran_port=Tran 

4800 END IF 

4810 END IF 

4820 IF Refl_port=0 THEN 

4830 Refl_port=Ref1 

4840 ELSE 

4850 IF Refl<>Refl_port THEN 

4860 Connect_refl(Refl_port ,Erase) 
4870 Refl_port=Ref1 

4880 END IF 

4890 END IF 

4900 Connect. tran(Tran.port ,Dim) 

4910 Connect_ref1l(Refl_port ,Dim) 

4920 SUBEND 

4930 ! 

4940 ! Softkey handler 

4950 ! Call from Srq to handler all softkey requests. Terminate program 
4960 | when ‘Done’ is pressed. 


4970 SUB Softkey_handler : 
4980 COM /Sys_state/ @Hp&7xx ,Scode, Keycode, Wind 


4990 ! 

5000 IF Keycode=0 THEN 

5010 CALL Select.refl 

5020 ELSE 

5030 IF Keycode=1 THEN 

5040 CALL Select. tran 

5050 ELSE 

5060 IF Keycode=4 THEN 

5070 OUTPUT @Hp87xx;"SYST:PRES; aWALT" ! Preset the 
system™M 

5080 STOP 

5090 END IF 

5100 END IF 

5110 END IF 

5120 SUBEND 

5130 ! 
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5150 
5160 
S170 
5180 


5190 ! 


5200 


5210 ! 


5220 
5230 
5240 
5250 
5260 
5270 
5280 
5290 
5300 
5310 
5320 
5330 
5340 
5350 


$360 ! 
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! Misc routines 
! 
Dipodoiei i doin acick IO SacI CRG IG AIC ICAI I ACE SE a AER aI AAR oF a 
! Iden.port: Identify io port to use. 
! Description: This routines sets up the I/0 port address for 
! the SCPI interface. For "HP 87xx" instruments, 
! the address assigned to GHp87xx = 800 otherwise, 
! 716. 
Lap SoS SSO IOI oR AO IE SCI FR Ra A I A 9 ICE ICCA OC 
SUB Iden_port 
COM /Sys_state/ @Hp87xx ,Scode ,Keycode,Wind 
t 
IF POS(SYSTEM$("SYSTEM ID") ,"HP 87")<>0 THEN 
ASSIGN @Hp87xx TO 800 
Scode=8 
ELSE 
ASSIGN @Hp87xx TO 716 
Scode=7 
END IF 


SUBEND !Iden_port 
; 
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1170 
1180 
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TSET_CAL Example Program 


This program automates the process of recalling and performing an 

HP 87075C multiport test set cal. This program first attempts to recall 
“ToET_CAL.CAL’” from non-volatile RAM, then the internal disk drive. If the 
recall is successful, it invokes the recalled test set cal for transmission and 
reflection of measurement channels 1 and 2. 


NOTE 


This program only works with the HP 870750 multipori test set. 


! Filename: TSET_CAL, recall test set cal 


i 
: 
! Description: 

: This program will try to recall tset.cal.cal from NVRAN if file 

: is present. If not, it will then try to recall tset_cal.cal from 
7 INT device instead. If recall successful, it will then do test 

! set cal for Transmission and Reflection of Channel i and Channel 


! Common Variables 
COM /Sys.state/ OHp87xx,Scode,Errnum 
! Identify I/0 Port 
CALL Iden_port 
OUTPUT @Hp87xx;"syst:pres;*wai" ! Reset the instrument 
CALL Recall _tset cal 
IF (Errnum=0) THEN 
PRINT "Doing Test set cal.........++-e-ee- “ 
CALL Tsetcal 
PRINT "Test Set cal complete" 
END IF 
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1190 } 

1200 OUTPUT @Hp87xx;"syst :pres ;*wai" ! Reset the instrument 
1210 ! 

1220 STOP 

1230 END 

1240 ! 

1250 bassdakoookobdiic daca anc Ha GEAR AOE AICI IR a aOR RE Io 
1260 ! TsetCal: Do Test set Cal. 

1270 ! Description: This routine will do test set cal for both 
1280 ! Transmission and Reflection of Channel 1 and 
1290 ! Channel 2. 

1300 pagauR oC aodadd dood a idciok dois iok a kok ack iiooiioiotaiodaciniciof aio aki 
1310 SUB Tsetcal 

1320 COM /Sys_state/ @Hp87xx,Scode,Errnum 


1330 ! 

1340 |! Do Test set cal for channel 1 Transmission 

1350 OUTPUT @Hp87xx;"sensi:stat ON; *wai” 

1360 OUTPUT @Hp87xx;"sensi:func *’xfr:pow:rat 2,0’?;det nban; *wail 
1370 OUTPUT @Hp87xx;"sensi:corr:testset ; xwai" 

1380 ! 

1390 ! Do Test Set cal for channel 1 Reflection 

1400 QUTPUT @Hp87xx;"sensi:stat ON; ‘wai™ 

1410 QUTPUT @Hp87xx;"sensi:func ’xfr:pow:rat 1,0’;det nban; *wai" 
1420 OUTPUT @Hp87xx;"sensi:corr:testset; *wai" 

1430 ! 

1440 ! Do Test set cal for channel 2 Transmission 

1450 OUTPUT @Hp87xx;"sens2:stat ON; *wai" 

1460 OUTPUT @Hp87xx;"sens2:func ’xfr:pow:rat 2,0°;det mban; *wai" 
1470 OUTPUT @Hp87xx;"sens2:corr:testset; *wai" 

1480 ! 

1490 ! Do Test Set cal for channel 2 Reflection 

1500 OUTPUT @Hp87xx;"sens2:stat ON; *wal" 

1510 OUTPUT @Hp87xx;"sens2:func ’xfr:pow:rat 1,0’;det nban; *wai" 
1520 QUTPUT GHp87xx;"sens2:corr:testset ; xwai" 

1530 SUBEND 

1540 ! 
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TESO sao ainiok seiko kak dak kek aS i 2k aR 3 ak a a A a a aK A 2 ICA CE A A Ea 
1560 ! Recall_tset cal: Recall Test Set Cal. 
1570 ! Description: This routine will try to recail tset_cal.cal 


1880 ! 
1530 ! 
1600 ! 


from NVRAM if available. If file not found, 
it will then try to recall tset_cal.cal from 
INT device instead. 


4610 eon O AIOE RG CII SRA RE AC ak cok ak fea ok 90k aa 
1620 SUB Recalltset_cal 


1630 
1640 
1650 ! 
1660 ! 
1670 ! 
1680 
1690 
1700 
1710 
1720 
1730 
1740 
1750 
1760 
1770 
1780 
1790 
1800 
1810 
41820 
1830 
1840 
1850 
1860 
1870 ! 


COM /Sys_state/ @Hp87xx,Scode ,Errnum 
DIM E$[120] 


Clear the status register and event status 


register. 
QUTPUT @Hp87xx;"%xcls;*ese 0" 
PRINT "Recalling tset_cal.cal from NVRAM ASVECO Gas 28 wees au 


OUTPUT @Hp87xx;"mmem:load:stat 1,’mem:tset_cal.cal’" 
OUTPUT GHp87xx;"syst:err?" 
ENTER @Hp87xx;Errnum ,E$ 
IF (Errnum<>0) THEN 
PRINT E¢ 
PRINT "Recalling tset_cal.cal from INT device.......... a 
OUTPUT @Hp87xx;"mmem:load:stat 1,’int:tset_cal.cal’" 
OUTPUT GHp87xx;"syst:err?" 
ENTER @Hp87xx;Errnum,E$ 
IF (Zrrnum=0) THEN 
PRINT "Recall complete" 
ELSE 
PRINT '"TSET_CAL.CAL is not present, recall aborted" 
END IF 
ELSE 
PRINT "Recall complete" 
END IF 


1880 SUBEND!Recall_tset_cal 


1890 ! 
1900 ! 
i910 ! 
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Example Programs 
Multiport Test Set Measurements 


1920 ses dasa doi dadgor ian ai Gk iok i cai a i 1 i a a a aa ok ok i ak i ak ak aK a ok oo 


1930 ! Iden_port: Identify io port to use. 

1940 ! Description: This routines sets up the I/O port address for 
I 
' 


1950 the SCPI interface. For "HP 87xx" instruments, 
1960 the address assigned to @Hp87xx = 800 otherwise, 
1970 ! 716. 


1980 sda pada nado io aa a aR AGRI AACA ISIC Ia A a FR ACR oR a I A A 
1990 SUB Iden_port 


2000 COM /Sys_state/ @Hp87xx ,Scode,Errnum 
2010 ! 

2020 IF POS(SYSTEM$ ("SYSTEM ID") ,"HP 87")<>0 THEN 
2030 ASSIGN @Hp87xx TO 800 

2040 Scode=8 

2050 ELSE 

2060 ASSIGN @Hp87xx TO 716 

2070 Scode=7 

2080 END IF 

2090 ! 

2100 SUBEND! Iden. port 

2110 ! 
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1130 ! 
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TTL Output 


TTL_IO Example Program 


This program continuously reads the USER TTL port and reports the number 
of times the port has detected a closure (short) via an external switch. This 
program is useful in a production environment where a device must be 
properly connected, either manually or by automated means, where the 
analyzer must wait for a signal from the operator that the DUT is in place and 
is ready to be tested. 


This program reads the user TTL port continuously until a short (0) is 
detected. Once this has been detected, a message is displayed. It then waits 
for the switch to open (1) and displays another message. At this point, code 
can be added to take a sweep and measure the DUT. The total number of 
cycles is counted and is displayed. 


Filename: TTL1I0 


1 
! 
! This program reads the USER TTL I0 

! port, and counts how many times a 

{ switch connected to the port is pressed. 
i 

DIM Msg$[200] 


INTEGER X 
1 


t 

COM /Sys_state/ @Hp87xx ,Scode 
! Identify I/O Port 

CALL Iden_port 

: 


i 
Pass_count=0 
Start: | 
Loop 
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1450 ! 


1460 
1470 
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1500 
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Example Programs 
TTL Output 


! Display message 
Msg$="’DUTs passed: "&VAL$(Pass_count)&CHR$(10) 
Msg$=Msg$&"Press button to measure next DUT.’" 
OUTPUT @Hp87xx;"DISP:ANN:MESS ";Msg$ 


! Wait for button to be pressed 
REPEAT 
OUTPUT @Hp87xx;"DIAG:PORT:READ? 15,1" 
ENTER GHp87xx;X 
UNTIL X=0 
DISP "Button is now pressed." 
OUTPUT @Hp87xx;"DISP:ANN:MESS: CLEAR” 


! Wait for button to be released 
REPEAT 
OUTPUT @HpS7xx;"DIAG:PORT:READ? 15,1" 
ENTER @GHp87xx;X 
UNTIL X=1 
DISP "Button is now released." 


OUTPUT @Hp87xx;"DISP:ANN:MESS ’Measuring...’" 
! Add code here to take sweep 
! and measure DUT. 
WAIT 1 
Pass_count=Pass_countti 
END LOOP 
END 


' 

Dice dada inaa icibaiciok A aR a io aA I ACACIA A I AE AC HOR 
! Iden_port: Identify io port to use. 

! Description: This routines sets up the I/O port address for 

i: the SCPI interface. For "HP 87xx" instruments, 
! the address assigned to GHp87xx = 800 otherwise, 
: 716. 

Dido io in cg a ica acolo ro IO GR AGI CIR ICICRCICISE 3OR A AOR ACE CAR ACR ACE I 
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Example Programs 
TTL Output 


1530 SUB Iden_port 


1540 COM /Sys_state/ @Hp87xx,Scode 
1550 ! 

1560 IF POS(SYSTEM$ ("SYSTEM ID") ,"HP 87")<>0 THEN 
1870 ASSIGN @Hp87xx TO 800 
1580 Scode=8 

1590 ELSE 

1600 ASSIGN @HpS7xx TO 716 
1610 Scode=7 

1620 END IF 

1630 ! 

1640 SUBEND !Iden_port 

1650 ! 
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AM Delay 


AMDELAY Example Program 


This program demonstrates the calibration and AM delay measurement of a 
bandpass filter. 


NOTE 


This pragram can only be used with Option 1DA or 1DB. 


!Filename: AMDELAY 


1 
1 
t 
ij 
' 
t 
1 
1 
1 
' 
t 
I 
i 
1 
1 
' 
t 


DESCRIPTION: 

1) The HP871x analyzer is Preset, CH1 = Y/X, CH2 = AM Delay 
Pout=10dBm, Fstart=SOMHz, Fstop=400MHz, Display is scaled. 

2) User must connect splitter to RF Dut port, connect 
External detector X to one splitter arm, connect 
External detector Y to the other splitter arm. 

3) Analyzer performs an AM Delay calibration over 50-400MHz. 

4) User must connect the BPF test device between splitter 
and the External Y detector. 

5) Analyzer finds the BPF’s center frequency and -6dB bandwidth 
using the Bandwidth marker function. Fcenter and Fspan 
are set so the analyzer displays the ~6dB bandwidth. 
(Note: the analyzer also interpolates numbers for the 
AM Delay calibration when the frequencies are changed.) 

6) The Y/X marker 1 is set to max (for maximum transmission. 
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Example Programs 
AM Delay 


! 7) The AM Delay marker 1 is read out and displayed. 

! 8) The AM Delay trace is read out, and the first data point 
! is displayed. 

' 


ETT CCPLICCTCErt error rite re Tere Pe te Pe ee os et 
! DEFINITIONS 

t 

REAL Opc,Freq center ,Freq_span,Q_bpf,Loss_bpf,I,Mrkr_freq 
REAL Trace delay (1:201) ,Mrkr delay 

t 

1 CACC AC COC A 2 oR aS 9 a a Oo a a oo ok da a a doa 

! Determine computer type and assign i/o path 

) 


CLEAR SCREEN 

i 

COM /Sys_state/ @Hp87xx,Scode 
! Identify I/O Pert 

CALL Iden_port 

1 


i] 

i A SS HS 

! Preset analyzer; CH2 = AM Delay; CHi = External Broadband Y/X; RF 
Power = 10dBm. 

Xu Note that the Start and Stop frequencies are set before CH2 is set 

to AM Delay mode. This is done because when both AM Delay and 

: Y/X are selected, the analyzer switches to alternate sweep mode, so 

! by selecting the frequencies first, the start and stop frequencies 

: will be the same for both channels. 

' 

OUTPUT GHp87xx;"SYST:PRES; *0PC?" Ipreset instrument 

ENTER CHp87xx;Opc waits for PRESET to finish before 

proceeding 

DISP "Setting up AM Delay and Y/X measurement..." 

5 

OUTPUT @Hp87xx;"SENS1:FREQ:STAR 50 MHZ" !set start freq to 

include test filter 

QUTPUT @GHp87xx;"SENSi:FREQ:STOP 400 MHZ" !set stop freq to 

include test filter 

OUTPUT @Hp87xx;"SOURL:POW 10 DBM" 'set Source Power to 

10dBm 

i 
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1600 
1610 


1620 


1630 
1640 
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1700 


1710 


41720 


1730 
1740 
1750 
1760 
1770 
1780 


1790 
1800 
1810 


1820 


Exampie Programs 


AM Belay 
OUTPUT @Hp87xx;"SENSi:FUNC *XFR:POW:RAT 12,11’;DET BBAN;*WAI" 
ICHANi=broadband Y/X 
OUTPUT @Hp87xx;"DISP:WIND1:TRAC:Y:PDIV 1 DB” 'scale Y/X to idB/div 
OUTPUT @Hp87xx;"DISP:WIND1 :TRAC:Y:RLEV -3" !X/Y ref level =-3dB 
H 
OUTPUT @Hp87xx;"SENS2:FUNC *XFR:GDEL:RAT 12,11’ ;DET BBAN;*WAI” 
'CHAN2=AM Delay 
OUTPUT @Hp87xx;"SENS2:STAT ON; *War" 'turn on CHAN2. Results 
in Alt Sweep. 
OUTPUT @Hp87xx;"SENS2:BWID 250 HZ;*WAI" ‘Narrow BW for low noise 
OUTPUT @Hp87xx;"DISP:WIND2:TRAC:¥:PDIV 5E-9;*0PC?" 'scale AM Delay to 
Sns/div 
ENTER @Hp87xx ;Opc ‘wait for commands to 
finish 
1 
Pee em ee enn 
! Calibrate the AM Delay using the "CALIBRATE/Response" function 
i 
INPUT "CALIBRATE: Connect Y detector to splitter; press ENTER.",I 
DISP "Calibrating..." 
QUIPUT GHp87xx;"SENS2:CORR:COLL: 1ST OFF ;METH TRAN1;*WAI" !AM Delay 
Response Cal 
QUTPUT @Hp87xx;"DISP: ANN :MESS: AOFF" 'turn off 


message on screen 


OUTPUT @Hp87xx;"SENS2:CORR:COLL STAN1;*WAI; :SENS2:CORR: COLL :SAVE;*0PC?" 

Imeasure standard 

ENTER @Hp87xx ; Ope twait for calibration to 

finish 

INPUT “Insert BPF between splitter and Y detector; press ENTER.",I 

I 

ee at oa em lm 

! Set Center and Span frequencies to -6dB bandwidth of BPF. 

t 

! Center the filter’s frequency response (to get an accurate Bandwidth 
measurement) 

DISP "Setting analyzer frequencies..." imessage to user 

OUTPUT @Hp87xx;"ABOR; :INITL:CONT OFF;:INIT1;*0PC?" !perform single 

sweep 

ENTER @Hp87xx;Opc twait for sweep to 

finish 
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Example Programs 


AM Delay 
OUTPUT @Hp87xx;"CALC1:MARK:FUNC MAX;*0PC?" tset Marker to max 
ENTER @Hp87xx; Ope iwait for marker to move 
QUTPUT @Hp87xx;"CALC1:MARK :K?" tget Marker frequency 
setting 
ENTER @Hp87xx;Mrkr_freq tread frequency of max 
marker 
OUTPUT @Hp87xx;"SENS1:FREQ:CENT "&VAL$(Mrkr_freq)&" HZ;*WAI" {set 


marker to Center Freq 


QUTPUT @Hp87xx;"SENS1:FREQ:SPAN 200 NHZ;*WAI" tset Span Freq = 200MHz 
i 

1 Measure Bandwidth: Center frequency and -6dB Span frequency 

i 

OUTPUT @Hp87xx;"ABOR;:INIT1:CONT OFF;:INIT1;*OPC?" trestart sweep 
ENTER @Hp87xx;0pc 'wait for sweep to 
finish 

QUTPUT @Hp87xx;"CALC1:MARK:BWID —6;*WAI" tset bandwidth search to 
-6dB 

OUTPUT @Hp87xx; "CALCi: MARK: FUNC BWID;#0PC?" isearch filter for -6dB 
bandwidth 

ENTER @Hp87xx;0pc {wait for bandwidth to 
be found 

OUTPUT @Hp87xx; "CALC1:MARK : FUNC: RES?" 'read the bandwidth data 
ENTER @Hp87xx;Freq_span ,Freq_center ,Q_bpf,Loss_bpf tread 
in data 

OUTPUT @Hp87xx;"CALC1: MARK: AOFF ; *WAI" tmarkers off 

QUIPUT @Hp87xx;"ABOR; :INIT1:CONT ON; *WAI" trestart continuous 
sweep 

i 

QUIPUT @Hp87xx;"SENS1:FREQ:SPAN “&VAL$(Freq_span)&" HZ;+*WAI" !set 


Span Freq CHi 

OUTPUT C@Hp87xx;"SENS1:FREQ:CENT "&£VAL$(Freq_center)&" HZ;*WAI" !set 
Center Freq CHI 

OUTPUT @Hp87xx;"SENS2:FREQ:SPAN "&VAL$(Freq_span)&" HZ;*WAI" !set 
Span Freq CH2 

OUTPUT @Hp87xx;"SENS2:FREQ:CENT "&£VAL$(Freq_center)&" HZ;*WAI" !set 
Center Freq CH2 

i 

' ec ee an se me se he 

! Read marker information (frequency and delay) and display. 

! Note that the X-axis is swept frequency and the Y-axis 

d is delay in seconds. 
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Example Programs 


AM Delay 
! 
OUTPUT @Hp87xx;"CALC1:MARK1 ON" tturn on marker 1 on Y/X trace 
OUTPUT @Hp87xx;"CALC1:MARK: FUNC MAX" iset marker to max 
transmission 
OUTPUT OHp87xx;"CALC2:MARKi ON” Iturn on marker 1 on AM Delay 
trace 
OUTPUT @Hp87xx;"CALC2:MARK1:X?" 'read frequency at marker 
ENTER @Hp87xx;Mrkrfreq 
OUTPUT @Hp87xx;"CALC2:MARK1:Y?" tread marker delay value 


ENTER @Hp87xx;Mrkrdelay 
i 


DISP "Marker Frequency = "&VAL$(Mrkr_freq)&" Hz" ‘display frequency 
WAIT 3 

DISP "Marker Delay = "&VAL$(Mrkr_delay)&" Seconds" !display delay 
WAIT 3 


! Read AM Delay trace data, display first data point. 

! Data is transferred in ASCII format for simplicity. 

! Measured data is delay in seconds. Trace length=201 (default) 
i 


OUTPUT @HpS7xx;"FORM:DATA ASC,5; : TRAC? CH2FDATA" tmeasure formatted 
data 

ENTER @Hp87xx;Trace_delay(*) !read in data 

1 


DISP “Trace Point #1: AM Delay = "&#VAL$(Trace_delay(1))&" Seconds" 
WAIT 3 
t 


DISP "" 'clear display line 

i 

STOP 

END 

t 

Da agcc AO AGG Kaa A Oa IOI CI I CIO CAR aC ICR I IR A ER A EAC ER a IE 
! Iden.port: Identify io port to use. 

! Description: This routines sets up the 1/0 port address for 

! the SCPI interface. For "HP 87xx" instruments, 
1 the address assigned to @Hp87xx = 800 otherwise, 
J 716. 
Prtetrrrtetittirreerrerire iret rs Ste se Sete tet see eS eS 
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Example Programs 


2480 SUB Iden_port 


2490 COM /Sys_state/ @Hp87xx ,Scode 
2500 ! 

2510 IF POS(SYSTEM$("SYSTEM ID") ,"HP 87")<>0 THEN 
2520 ASSIGN @Hp87xx TQ 800 
2530 Scode=8 

2540 ELSE 

2550 ASSIGN @Hp87xx TO 716 
2560 Scode=7 

2570 END IF 

2580 ! 

2590 SUBEND !Iden_port 

2600 ! 
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Front Panel Keycodes 


Controlling the Front 
Panel 


Monitoring the Front 
Panel 


Front Panel Keycodes 


Your program can control or monitor the analyzer’s front panel with the use 
of the SCPI SYSTem: KEY commands. 


The front panel can be controlled by sending commands to execute the 
function of specific keys. The SCPI command SYSTem:KEY <char> sends 

a key name to the analyzer which executes the same function as the 
corresponding front panel key. For example, SYSTem: KEY FREQ will execute 
the function of the hardkey. 


Every hardkey and softkey have a unique key name. Refer to the last table in 
this chapter for a list of all key names. 


The front panel can be monitored to determine when a key has been pressed 
or when the knob (RPG — rotary pulse generator) has been turned. Key 
presses from an attached PC DIN keyboard can also be captured. 


When keys are pressed or when the knob is turned, the analyzer detects 

this event, sets bit 0 of the Device Status Register (see Chapter 5, “Using 
Status Registers”) and stores the associated information in a key queue. Your 
program can use the SCPI SYSTem: KEY commands to read the contents of the 
key queue. 


The SCPI query SYSTem:KEY : TYPE? returns a string indicating the type of 
key press event: 


Retura Value Meaning 
NONE Ne key has been pressed 
KEY A front panel key has been pressed 
RPG The analyzer’s knob has been turned 
ASC A key on the ASCH PC DIN keyboard has been pressed 


The SCPI query SYSTem:KEY[:VALue]? returns a number describing the 
type of key press. The meaning of the number depends on the key type 
returned by the SYSTem:KEY: TYPE? query: 
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Front Panel Keycodes 


SYST :KEY: TYPE SYST: KEY : VALUE Meaning 
NONE No meaning. Returns ~1. 
KEY A number from @ to 56 representing the “key code” of the front 


panel key. See following table for list. 


APG The number of knob “ticks.” Positive values indicate 2 cleck-wise 
turn; negative numbers indicate counter-clockwise. Larger numbers 
indicate the knob has been tured faster or further. 


ASC The ASCH value of the pressed key. 


= 


The SYSTem:KEY[:VALue]? query removes the key from the key queue, 
so that you can read the next key. For this reason, you must perform the 
SYSTem:KEY: TYPE? query before performing the SYSTem:KEY[:VALue]?. 


The queue that stores the key press events has a finite length. In firmware 
revision B.03.00, this length is 32. This means that after 32 key presses occur 
without being read (using SYSTem:KEY[:VALue] ?), subsequent key presses 
or knob ticks will be ignored. 


Your program can query the queue length using the SCP! command: 
SYSTom: KEY :QUEue :MAXimum? 

You can clear the queue using: 
SYSTem: KEY : QUEue :CLEar : 

You can check how many key presses or knob tick events have occurred using 
SYSTem: KEY : QUEUE :COUNt? 

Finally, you can turn the key queue on or off using 
SYSTem:KEY:QUEUE[:STATe] <ON|OFF> 


When the queue is turned off, your program must read each key before a 
following key is pressed, or information will be lost. It is generally best to 
leave the queue enabled. 


For a complete example of how to read the front panel keys and knob, refer 
to the KEYCODE example program. 
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Key Group Hey Label Key HP-B 
Cade Key Name 
Softkeys Softkey 1 {top keyl 0 SOFTkey1 
Softkey 2 1 |SOFTkey2 
Softkey 3 2 |SOFTkey3 
Softkey 4 3 |SOFTkey4 
Softkey 5 4 |SOFTKey5 
Softkey 6 5 |SOFTkey6 
softkey 7 6 |SOFTkey7 
Softkey 8 lbotom key! 7 | SOFTkeys 
Numeric Keys | (Q) Izero] 10 | ZERO 
fone} di | ONE 
{two} 12 | Two 
(three) 13 |THRee 
{four 14 [FOUR 
{five] 15 | FIVE 
@ isixi 16 |SIX 
\seven! 17. |SEVen 
leight) 18 |EIGHt 
(9) Inine) 19 | NINE 
20 «| EllTer 
(D) tdecimat 21 |POINe 
{minus/backspacel 22 = |MINus 
(® tstep upi 23 «| UP 
(@® step down! 24 (DOWN 
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Key Group Key Label Key HPIB 
Code Key Name 
Feature Keys 40 |BEGin 

MEAS 1 41 | MEASL 

42 | MEAS2 

43° | POWer 

44 | MEWU 

45 | FREQ 

46 |SWEep 

47 | CAL 

4g |DISPlay 

49 |SCALe 

so. | AVG 

51 | FORMat 

52 |MARKer 

53 | SAVE 

54 | SYSTem 

55 |HARDcopy 
PRESET. 56 |PRESet 
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Introduction to SCPI 


This chapter is a guide to HP-IB control of the analyzer. Its purpose is to 
provide concise information about the operation of the analyzer under HP- 
control. The reader should already be familiar with making measurements 
with the analyzer and with the general operation of HP-IB. 


Standard Commands for Programmable Instruments (SCPI) is a programming 
language designed specifically for controlling instruments by Hewlett-Packard 
and other industry leaders. SCPI provides commands that are common from 
one instrument to another. This elimination of “device specific” commands 
for common functions allows programs to be used on different instruments 
with very little modification. 


SCPI was developed to conform to the IEEE 488.2 standard 

(replacing IEEE 728-1982). The IEEE 488.2 standard defines the syntax and 
data formats used to send data between devices, the structure of status 
registers, and the commands used for common tasks. For more information, 
refer to the IEEE standard itself. SCP! defines the commands used to control 
device-specific functions, the parameters accepted by these functions, and the 
values they return. 
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The Command Tree 


The SCPI standard organizes related instrument functions by grouping them 
together on a common branch of a command tree. Each branch is assigned a 
mnemonic to indicate the nature of the related functions. The analyzer has 
16 major SCPI branches or subsystems. See Figure 10-1 for a model of how 
these subsystems are organized to manage the measurement and data flow for 


the analyzer. 


PROGram | 
a 
| STATus 


SYSTem 


Aor 
Bor2 
Rord 


Ext X or 1 ee ena 
Xi 


includes | 
ABOR: | 
INTiate imate _| 


External Trigger 


z 


| 

i 

caesar | ation F | 

TRiGger nel | 


DISPiay pf ucory | 


: 

i data 

i LO oe _ 
SENSe vince’ | FORMat > a] 


HP-IB 


| 

MMEMory 
| I 
on 


¥ 


Pont reamaa| OUTPut 
Source L 


: dat | 
SOuRce b-—| TRACe | FORMat bee 


Figure 10-1. Measurement and Data Flow of the Analyzer 
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introduction te SCP 
The Command Tree 


The analyzer’s major SCP] subsystems and their functions are described 
below. 


ABORt Aborts any sweep in progress. 


CALCulate Configures post-measurement processing of the measured 
data (such as marker and limit testing functions). 


cCALibration Controls zeroing the broadband diode detectors. 


DIsPlay Controls the display of measurement data, annotation and 
user graphics. 
FORMat Controls the format of data transfers over the HP-B. 


(For more information about. HP-IB data transfer refer to 
Chapter 4, “Data Types and Encoding.”) 


HCOPy Controls hardcopy (printer and plotter) output. 

INITiate Controls the triggering of sweeps. 

MMEMory Controls mass storage of instrument states and data (disk 
and internal memory interface functions). 

oUuTPut Turns on/off the source output power (power to the device 
under test). 

PROGram Interfaces IBASIC programs and commands with an 


external controlier. (For more information on IBASIC 
programming refer to HP Instrument BASIC User’s 
Handbook.) 


SENSe Configures parameters (such as the frequency and 
measurement parameters) related to the sweep and 
the measured signal (from the device under test). This 
subsystem also controls the narrowband calibration 
routines. 


SOURce Controls the RF output power level of the source (power to 
the device under test). 
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STATus Contains the commands for using the SCPI status registers. 
(For more information about using the status registers refer 
to Chapter 5, “Using Status Registers. ”) 


SYSTem Contains miscellaneous system configuration commands 
(such as I/O port, clock and softkey control). 


TRACe Interfaces with the internal data arrays (functions such as 
data transfer and trace memory). 


TRIGger Controls the source of the sweep triggering. 


When many functions are grouped together on a particular branch, additional 
branching is used to organize these functions into groups that are even more 
closely related. The branching process continues until each analyzer function 
is assigned to its own branch. For example, the function that turns on and 
off the marker tracking feature is assigned to the TRACKING branch of the 
FUNCTION branch of the MARKER branch of the CALCULATE subsystem. The 
command looks like this: 


CALCULATE: MARKER : FUNCTION: TRACKING ON 


NOTE 


Colons are used te indicate branching points on the command tree. A parameter is separated from the 
rest of the command by a space 
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CALCuUlate 
| 
MARKer 
[ me j MODE FUNCtion MAXimum 
i i [ee = pil 
| QwiDtn TRACking  RESU1t 
| | 
| COMMAND TREE 
a eo 
| PARAMETERS 
i 1 j | 
ON OFF ABSolute RELative ON OFF 


Figure 10-2. Partial Diagram of the CALCulate Subsystem Command Tree 
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Sending Multiple Commands 


Multiple commands can be sent within a single program message by 
separating the commands with semicolons. For example, the following 
program message — sent within an HP BASIC OUTPUT statement — turns on 
the marker reference and moves the main marker to the highest peak on the 
trace: 


OUTPUT 716; CALCULATE : MARKER :MODE 
RELATIVE; : CALCULATE : MARKER : MAXIMUM" 


One of the analyzer’s command parser main functions is to keep track of a 
program message’s position in the command tree. This allows the previous 
program message to be simplified. Taking advantage of this parser function, 
the simpler equivalent program message is: 


QUTPUT 716;"CALCULATE: MARKER :MODE RELATIVE ; MAXIMUM" 


In the first version of the program message, the semicolon that separates the 
two commands is followed by a colon. Whenever this occurs, the command 
parser is reset to the base of the command tree. As a result, the next 
command is only valid if it includes the entire mnemonic path from the base 
of the tree. 


In the second version of the program message, the semicolon that separates 
the two commands is not followed by a colon. Whenever this occurs, the 
command parser assumes that the mnemonics of the second command arise 
from the same branch of the tree as the final mnemonic of the preceding 
command. MODE, the final mnemonic of the first command, arises from the 
MARKER branch. So MAXIMUM, the first mnemonic of the second command is 
also assumed to arise from the MARKER branch. 


The following is a longer series of commands — again sent within HP BASIC 
QUTPUT statements — that can be combined into a single program message: 


OUTPUT 716; "CALCULATE :MARKER:STATE ON" 

OUTPUT 716;"CALCULATE:MARKER:MODE RELATIVE" 

OUTPUT 716 ;"CALCULATE : MARKER : MAXIMUM" 

OUTPUT 716; "CALCULATE: MARKER: FUNCTION: TRACKING ON" 


The single program message is: 


OUTPUT 716; "CALCULATE :MARKER:STATE ON;MODE 
RELATIVE ; MAXIMUM; FUNCTION: TRACKING ON" 
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Command Abbreviation 


Each command mnemonic has a long form and a short form. The short forms 
of the mnemonics allow you to send abbreviated commands. Only the exact 
short form or the exact long form is accepted. 


The short form mnemonics are created according to the following rules: 


e If the long form mnemonic has four characters or less, the short form is the 
same as the long form. For example, DATA remains DATA. 


e If the long form mnemonic has more than four characters and the fourth 
character is a consonant, the short form consists of the first four characters 
of the long form. For example, CALCULATE becomes CALC. 


e if the long form mnemonic has more than four characters and the fourth 
character is a vowel, the short form consists of the first three characters of 
the long form. For example, LIMIT becomes LIM. 


NOTE 


The short form of a particular mnemonic is indicated by the use of UPPER-CASE characters in this 
manual. 


SCPI is not case sensitive so any mix of upper- and lower-case lettering can be used when sending 
commands to the analyzer. 


If the rules listed in this section are applied to the last program message in 
the preceding section, the statement: 


OUTPUT 716;"CALCULATE :MARKER:STATE ON;MODE 
RELATIVE ; MAXIMUM; FUNCTION: TRACKING ON" 


becomes: 
OUTPUT 716;"CALC:MARK:STAT ON;MODE REL;MAX;FUNC:TRAC ON” 
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Implied Mnemonics 


Some mnemonics can be omitted from HP-IB commands without changing 

the effect of the command. These special mnemonics are called implied 
mmemonics, and they are used in many subsystems. In addition to entire 
mnemonics, variable parts of some mnemonics may also be implied. These 
are usually a number indicating a particular measurement channel, marker, or 
similar choice. 


NOTE 


When a number is not supplied for an implied variable, a default choice is assumed; this choice is 
always 1. 


The INITIATE subsystem contains both the implied mnemonic IMMEDIATE 
at its first branching point and an implied variable for the measurement 
channel. The command to trigger a new sweep is shown in the “SCPI 
Command Summary” as: 


OUTPUT 716;"INITiate[1|2] [:IMMediate] 


Any of the following forms of the command can be sent to the analyzer (using 
HP BASIC) to trigger a new sweep on measurement channel 1: 


OUTPUT 716;"INITIATE1: IMMEDIATE" 
OUTPUT 716;" INITIATE: IMMEDIATE" 
OUTPUT 716;"INITIATEL" 

OUTPUT 716;"INITIATE" 


If the sweep is to be triggered for measurement channel 2, the channel 
number must be specified: 


OUTPUT 716;"INITIATE2: IMMEDIATE" 
OUTPUT 716;"INITIATE2" 
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Parameter Types 


Parameters are used in many commands. The analyzer uses several types of 
parameters with different types of commands and queries. When a parameter 
is sent with a SCPI command it must be separated from the command by a 
space. If more than one parameter is sent they are separated from each other 
by commas. 


Numeric Parameters 


Most subsystems use numeric parameters to specify physical quantities. 
Simple numeric parameters accept all commonly used decimal representations 
of numbers, including optional signs, decimal points, and scientific notation. 
If an instrument setting programmed with a numeric parameter can only 
assume a finite number of values, the instrument automatically rounds the 
parameter. In addition to numeric values, all numeric parameters accept 

MAX imum and MINimum as values (note that MAXimum and MINimum can be 
used to set or query values). 


<num> is used in this document to denote a numeric parameter. 


An example is the command to set the stop frequency for a measurement. 
The first command below sets the stop frequency to a specific value. The 
second command below sets the stop frequency to its maximum possible 
value (1300 MHz for HP 8711C/12C or 3000 MHz for HP 8713C/14C). 


OUTPUT 716;"SENSE1:FREQUENCY:STOP 1300 MEZ" 


OUTPUT 716;"SENSE1:FREQUENCY:STOP MAX" 
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Query Response 


Query Response 


Introduction to SCPI 
Parameter Types 


When a numeric parameter is queried the number is returned in one of the 
three numeric formats. 


NR1 Integers (such as +1, 0, -1, 128, -12345) 


NR2 Floating point number with an explicit decimal point (such as 
12.8, +1.234, -0.12345) 


NR3 Floating point number in scientific notation (such as 
+1.28E+5, +123.4E-3, -456.789E+6) 


An example is the response to a query of the stop frequency after executing 
the above commands (this response is of the NR8 type). 


OUTPUT 716; "SENSE1: FREQUENCY : STOP?" 


returns the value 1.3E+9. 


Character Parameters 


Character parameters (sometimes referred to as discrete parameters) consist 
of ASCE characters. They are typically used for program settings that have a 
finite number of values. 


These parameters use mnemonics to represent each valid setting. They have 
along and a short form which follow the same rules as command mnemonics. 


<char> is used in this document to denote a character parameter. 


An example of a command using a character parameter is the command that 
selects the format in which the measurement data is displayed: 


OUTPUT 716; "CALCULATE1: FORMAT MLOGARITHMIC" 


When a character parameter is queried the response is always the short form 
of the mnemonic that represents the current setting. An example is the 
response to a query of the data format after executing the above command. 


OUTPUT 716; "CALCULATE1: FORMAT?" 
returns the value MLOG. 
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Query Response 


Introduction ta SCPI 
Parameter Types 


Boolean Parameters 


Boolean parameters are used for program settings that can be represented by 
a single binary condition. Commands that use this type of parameter accept 
the values ON (or 1) and OFF (or 0). 


<ON|OFF> is used in this document to denote a boolean parameter. 


An exarnple of a command that uses 2 boolean parameter is the command 
that makes the analyzer continuously trigger (or stop triggering) 
measurements. 


OUTPUT 716;"INITIATE: CONTINUOUS ON" 


A special group of coramands uses boolean parameters to control automatic 
functions of the instrument, such as automatically selecting the fastest 
possible sweep speed. With these automatic functions an additional value is 
available for the parameter. This value ONCE causes the function to execute 
once before turning off. 


The response when a boolean parameter is queried is a single NR1 number 
indicating the state 1 for on or 0 for off. An example is the response to a 
query on the sweep trigger status after executing the above command. 


OUTPUT 716;"INITIATE: CONTINUOUS?" 
returns the value 1. 
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Query Response 


Intreduction to SCPI 
Parameter Types 


String Parameters 


String parameters can contain virtually any set of ASCII characters. The 
string must begin with a single quote (’ ) or a double quote ( " ) and end 
with the same character (called the delimiter). The delimiter can be included 
as a character (embedded) inside the string by typing it twice without any 
characters in between. For example: 


OUTPUT 716;"DISP:ANN:TITL:DATA ’DUT’’S PHASE?" 
<string> is used in this document to denote a string parameter. 


A example of a command that uses a string parameter is the CONFIGURE 
cormmand: 


OUTPUT 716;"CONFIGURE ’ FILTER: TRANSMISSION?” 


Some of the string parameters used by the analyzer, like 

oFILTER: TRANSMISSION’ in the example above, follow the same rules that 
apply to mnemonics. They may have branching (* FILTER: REFLECTION? is a 
related command) and abbreviated versions. 


The response when a string parameter is queried is a string. The only 
difference is that the response string will only use double quotes as 
delimiters. Embedded double quotes may be present in string response data. 
When the string follows the “SCPI’ mnemonic rules, the string returned in 
response to a query is in the abbreviated form. An example is the response 
to the configuration status of the analyzer (after executing the last command). 


QUTPUT 716; "CONFIGURE?" 
returns the value "FILT: TRAN". 
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Block Parameters 


Block parameters are typically used to transfer large quantities of related data 
(like a data trace). Blocks can be sent as definite length blocks or indefinite 
length blocks —- the instrument will accept either form. For more information 
on block data transfers refer to Chapter 4, “Data Types and Encoding.” 


<block> is used in this document to denote a block parameter. 
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Syntax Summary 


The following conventions are used throughout this manual whenever SCPI 
mmemonics are being described. 


angle brackets (< >) are used to enclose required parameters within a 
command or query. The definition of the variable is 
usually explained in the accompanying text. 


square brackets ([ ) are used to enclose implied or optional parameters 
within a command or query. 


UPPERlower case are used to indicate the short form (upper-case) of a 
given mnemonic. The remaining (lower-case) letters 
are the rest of the long form mnemonic. 


[ LU 
| 
a ee 
(| 1 Wee 
KEYWORD |-+I4 space(s) + parameter el suffix : EOL 
| : H es = 
Bl 
| 
Ce, / 


Figure 10-3. SCPI Command Syntax 
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Syntax Summary 


The following elements have special meanings within a SCP! program 
message (or combination or mnemonics). 


colon (:) When a command or query contains a series of 
mnemonics, they are separated by colons. A colon 
immediately following a mnemonic tells the command 
parser that the program message is proceeding to the 
next level of the command tree. A colon immediately 
following a semicolon tells the coramand parser that 
the program message is returning to the base of the 
command tree. 


semicoion (;} When a program message contains more than one 
command or query, a semicolon is used to separate them 
from each other. 


comma (,) A comma separates the data sent with a command or 
returned with a response. 


space () One space is required to separate a command or query 
from its data (or parameters). Spaces are not allowed 
inside a cormmand or query. 
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IEEE 488.2 Common Commands 


IEEE 488.2 defines a set of common commands. All instruments are required 
to implement a subset of these commands, specifically those commands 
related to status reporting, synchronization and internal operations. The rest 
of the common commands are optional. The following list details which of 
these IEEE 488.2 coramon commands are implemented in the analyzer and 
the response of the analyzer when the command is received. 


*CLS 


*ESE <num> 


*ESE? 


*ESR? 


*IDN? 


Clears the instrument Status Byte by emptying the error 
queue and clearing all event registers, also cancels any 
preceding *OPC command or query (does not change the 
enable registers or transition filters). 


Sets bits in the Standard Event Status Enable Register — 
current setting is saved in non-volatile memory. 


Reads the current state of the Standard Event Status Enable 
Register. 


Reads and clears the current state of the Standard Event 
Status Register. 


Returns a string that uniquely identifies the analyzer. The 
string is of the form 


"HEWLETT-PACKARD ,8711C,<serial number>,<software revision>" 


*LRN? 


*OPC 


This retums a string of device specific characters that, when 
sent back to the analyzer will restore the instrument state 
active when *LRN? was sent. Data formatting (ENTER USING 
"-K" in HP BASIC) or a similar technique should be used to 
ensure that the transfer does not terminate on a carriage 
return or line feed (both Cp and 'p are present in the learn 
string as part of the data). 


Operation complete command. The analyzer will generate 
the OPC message in the Standard Event Status Register 
when all pending overlapped operations have been 
completed (e.g. a sweep, or a preset). For more information 
about overlapped operations refer to “Overlapped 
Commands” in Chapter 2. 
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Introduction to SCP| 
IEEE 488.2 Common Commands 


*OPC? Operation complete query. The analyzer will return an 
ASCI “1” when all pending overlapped operations have 
been completed. 


*OPT? Returns a string identifying the analyzer’s option 
configuration. The string is of the form "1E1,1C2". The 
options are identified by the following: 


TEC 78 chm 
161 80 dB step attenuator 
C2 IBASIC 


1DA AN delay (80 Q) 

DB AM delay (75 1 

1F? LAN 

100 SRL and Fault Location 


*PCB <num> Sets the pass-control-back address (the address of the 
controller before a pass control is executed). 


*PSC <num> Sets the state of the Power-on Status Clear flag — flag is 
saved in non-volatile memory. This flag determines whether 
or not the Service Request enable register and the Event 
Status enable register are cleared at power-up. 


*RST Executes a device reset and cancels any pending *OPC 
cornmand or query. The contents of the instrument's 
nonvolatile memory are not affected by this command. 


This command is different from the front panel 
function in the state of the commands (and their reset 
states) listed below, 


The preset instrument state is described in the User’s Guide. 


INITiate :CONTinuous = OFF 
oUTPut [:STATe] = OFF 
CAaLibration: ZERO: AUTO - OFF 
SENSe : CORRection[:STATe] = OFF 
SEWSe: SWEep:POINts = MAX 
SOURce: POWer » MI 


*SRE <num> Sets bits in the Service Request Enable Register. Current 
setting is saved in non-volatile memory. 
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+*SRE? 


¥STB? 


¥*TRG 


TST? 


#WAT 


Introduction to SCP] 


Reads the current state of the Service Request Enable 
Register. 


Reads the value of the instrument Status Byte. This is a 
non-destructive read, the Status Byte is cleared by the #CLS 
command. 


Triggers a sweep on the active measurement channel when 
in Trigger Hold mode. Ignored if in continuous sweep. 


Returns the result of a complete self-test. An ASCID0 
indicates no failures found. Any other character indicates a 
specific self-test. failure. Does not perform any self-tests. See 
the Service Guide for further information. 


Prohibits the instrument from executing any new commands 
until all pending overlapped cormmands have been 
completed. 
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Menu Map with SCPI 
Commands 


Menu Map with SCPI Commands 


This chapter contains a map of all the softkey menu choices in the analyzer. 
There is a table for each major hardkey on the analyzer’s front panel. The 
softkeys are shown with corresponding SCPI commands (if one exists). 
Hardkeys are indicated with the notation, softkeys are shown as 


Softkeys. SCPI commands are all shown in their short form. 


Some commands (such as source settings) have mnemonics that specify the 
measurement channel in use. These mnemonics are shown as SENS[112]: . 
. indicating that either measurement channel could be used. The actual 
mnemonic entered would be SENS1: ... for setting measurement channel 1 
or SENS2: ... for measurement channel 2. Mnemonics for keys that toggle 

between two states are shown as ... ONJOFF. 


<num> and <string> refer to parameter types described in the “Parameter 
Types” section. <string> parameters are typically enclosed in single quotes 
( the string data’). 


SCPI Command 


KEYSTROKES SCPI COMMAND 


SYST: PRES ; #WAT 
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Menu Mao with SCP] Commands 


BEGIN} SCPI Commands 
KEYSTROKES SCPI COMMAND 

BEGIN 
Anplifier 

Transmissn CONF *AMPL: TRAN? ; #WAT 

Reflection CONF *AMPL:REPL? ; WAT 

Power CONF ’AMPL:POW?; WAT 
Filter. 

Pransmissn CONF ?FILT:TRAW? ; *WAT 

Reflection CONF ?FILT:REFL? ; +#WAT 


Broadbend Passive 


CONF 
CONF 


CONF 
CONF 
COUF 


* BRAN: TRAN? ; *WAT 
*BBAN:REFL? ; *Wal 


MIX :CLOS? ; *WAI 
MIX: REFL? ;*WAI 
MIX:GDEL? ; *WAI 


1 Options 1DA and 1DB oniy 
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Menu Map with SCP! Commands 


SCP Commands {eentinued) 


KEYSTROKES == iD, ScPl COMMAND 
as Raa 
Cable t 
Transmissn CONF (1]2] *CABL: TRAN’ ;*¥AT 
Reflection CONF [4112] °CABL:REFL? ;*WAT 
Fault Location CONF [112] *CABL: FAULT? ; *WAI 


Start Distance 
Stop Distance 
Feet 

Meters 

Low Pass. 

Band Pass 

Center Er equency 


Units 


SRL 
Start Freq 
Units 


Stop. Preq 
dite 


Connector Model 
Measure Connector 
Connector Length 
Goanccter ¢ 


SENS[1]2]:DIST:STAR <num> [FEET|MET];*WAI 
SENS[1|2] :DIST:STOP <num> [FEET|MET];*WaI 
SENS: DIST: UNIT FEET 

SENS: DIST: UNIT MET 

SENS: FREQ: MODE LOWP; *WAT 

SENS: FREQ:MODE CENT; *WAI 

DISP: ANN: FREQCi|2]:MODE CSPAN 


SEWS[1/2]:FREQ:CENT <num> [MHZ|KEZIEZ]; 
#41 
CONF(112] ?CABL: SRL? ; *WAT 
DISP: ANN: FREQ(112]:MODE SSTOP 


SENS[1 
*WAI 


2]:FREQ:STAR <num> [MHZ|KEZ|BZ1; 


DISP: ANN: FREQ(1|2]:MODE SSTOP 


SENS [1 
+WAI 


2Q]:FREQ:STOP <num> [MHZ|KEZ| #2]; 


SENS [11/2] : CORR: MODEL: CONN 


SEWS(1/2]:CORR:LENG:CONN <num> 


SEWS[112]:CORR:CAP: CONN <num> 


1 Option 100 oniy 
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Menu Map with SCPI Commands 


SCPI Commands (continued) 


KEYSTROKES 


SCPE COMMAND 


Z-Cutott Frequency 


ENTER 
Auto Z Ol oft 


Manual Z ENTER 
SRL Cable Scan 


Humber of Points ENTER 


User BEGIN’ 


SENS: FREQ:ZST <num> [MH2|KEZ| 82] 
SENS[1]2]:FUNC:SRL: MODE <AUTO|MANUAL> 
SEWS[1]2]:FUNC:SRL: IMP <num> 

SENS [1/2]: FUNC: SRL: SCAN; #WAT 
SENS[1]2]:SWE:POIN <num>;*WAl 


No SCPI command 


1 Option 1C2 only 


iL 


Menu Map with 


SCPI Commands 


| SCPI Commands 


L 


KEYSTROKES SCP COMMAND 
MEAS 1)| (ASS SENS(1 12] :STAT OW; *WAT 
Transmissa SENS(112]:FUNC *XFR:POW:RAT 2,07; 
DET NBAN; WAI 
Reflection SEWS[112]:FUNC °XPR:POW:RAT 1,07; 
DET NBAN ; *WAL 
Fault Location! SEWS[112]:FUNC *FLOC 1,0’; 
DET NBAN; +WAZ 
SRL SENS[112]:FUNC *SRL 1,0°5 
DET NBAN; *WAL 
Hore 
Power SENS[1|2]:FUNC ’XFR:POW 2° ;DET BBAN;*WAI 
Conversion Loss SENS{1|2]:FUNC *FR:POW:RAT 2,0’; 


Au Delay 2 


Detection Options 


Harrowband internal 


DET BBAN; #WAI 


SENS [112] : FUNC 
DET BBAN; *WAI 


SERS [112] : FUNC 
SENS [112] : FUNC 
SENS [112] : FUNC 


SENS[ 112] : FUNC 
DET NBAN; *WAI 


sews {4 |2] : FUNC 
DET NBAN; *WAT 


°XFR:GDEL:RAT 12,117; 


*XFR:POW 1? ;DET NBAM;+WAL 
*XFR:POW 2? ;DET NBAN; +WAT 
*KER:POW 0? ;DET NBAN; +*WALI 
*XFR:POW:RAT 1,07; 


>XPR:POW:RAT 2,07; 


1 Gptien 108 only 
2 Optisns 1BA and 1DB only 
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| SCPI Commands (continued) 


Menu Map with SCPI Commands 


i 


KEYSTROKES SCPI COMMAND 
Broadband “Internal 
Be SEWS[1|2]:FUNC °XFR:POW 2°;DET BRAN; *WAI 
RE SENS[1/2]:FUNC *XFR:POW 0° ;DET BRAN; *WAI 
Bs /Re SENS [1/2] :FUNC ?XFR:POW:RAT 2,07; 
DET BBAN; *WAT 
Broadband External 
x SEWS[i12]:FUNC ’XFR:POW 11’ ;DET BBAN; *WAI 
y SENS[112]:FUNC °XFR:POW 127 ;DET BRAN; *WAI 
uy SENS[1/2]:FUNC ?XFR:POW:RAT 11,427; 
DET BBAN; #WAT 
Y/% SENS[1[2]:FUNC °XFR:POW:RAT 12,117; 
DET BBAN;*WAI 
Y/Re SEWS[1[2]:FUNC °XFR:POW:RAT 12,07; 
DET BBAN; *WAI 
UX Input SEWS(112]:FUNC °XFR:VOLT? ;+WAI 


Heas OFF 


1 Fer use with HP 87078C multiport test sets only 


sens[1|2] :STAT 


ROQUT[1|2] :REFL: 


<i}2[ ... [42> 


ROUT[1|2]: TRAN: 


<i]2l... [12> 


OFF ; *WAT 


PATE: DEF: PORT 


PATH: DEF : PORT 
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Menu Map with SCPI Commands 


FREQ) SCPI Commands 


KEYSTROKES 


ses: 


SCPI COMMAND 


Start 
Units 


Stop 


Units. 


Center 


Units 


Span 


Unite 


Cu. 


tales 


Faglt Loc. Frequency ! 


Low Pass 


Band Pass 


Band Pass Max Span Units 


DISP: ANN: FREQ(1 


SENS [1 
¥WAT 


DISP: ANN: FREQ(1 


SENS [1 
*WAT 


DISP: ANN: FREQ(4 


SENS [1 
+WAT 


DISP: ANN: FREQ(1 


SENS [4 
¥WAL 


DISP: ANN: FREQ(1 
:SENS[4|2] : FREQ 


SENS [4 
*WAT 


SENS : FREQ: MODE 
| SENS : FREQ: HODE 


SENS [112]: FREQ: 
(MHZ |KE2Z{ #2] 


2) :MODE SSTOP 


2] :FREQ:STAR <num> [MHZ 


2] :MODE SSTOP 


2):FREQ:STOP <num> [MHZ 


2]:MODE CSPAN 


21:FREQ:CENT <num> [HAZ 


2]):MODE CSPAW 


21: FREQ:SPAE <num> [MHZ 


21:MODE CW; 
SPAN 0; *WAT 


2] :FREQ:CENT <num> [HHZ 


LOWP ; #WAT 
CENT ; #WAI 
SPAN: MAX <num> 


KEZ 


KEZ 


KEZ 


KHZ 


KEZ 


HZ]; 


HZ]; 


HZ]; 


HZ]; 


HZ]; 


1 Gption 100 only 
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Menu Map with SCPI Commands 


SCP! Commands (continued) 


KEYSTROKES 


SCPI COMMAND 


Disp Freq Resolution 
MEz 
kEZ 


a 


DISP: ANN:FREQ:RES MHZ 
DISP: ANN: FREQ:RES KHZ 
DISP: ANN: FREQ:RES 42 


Menu Map with SCPI Commands 


SCPI Commands 


KEYSTROKES 


SCPI COMMAND 


POWER 


Level 


RE OW off 


Start Power (Number) (ENTER 


Stop Power ENTER 


SOUR: 


SOUR: 


SOUR: 
SOUR: 
SOUR: 
SOUR: 
SOUR: 
SOUR: 
SOUR: 
SOUR: 


POW: 


POW: 


Pow: 
POW: 
POW: 
POW: 
POW: 
POW: 
POW: 


POW: 


STAR 


STOP 


RANG 
RANG 
RANG 
RANG 
RANG 
RANG 
RANG 


SOUR[112]:POW <num> [dBm] ;*WAI 


OUTP <ON/OFF>;*WAT 


<num> [dBm] ;*WAI 


<num> [dBm] ;*WAT 


ATTO ;*WAI 
ATT10; *WAT 
ATT20; #WAT 
ATT30;#WAI 
ATT40; #WAT 
ATTSO;#WAT 
ATT6O; #WAI 


PRESET <num> [dBr] 


41 The numbers shown on the range keys will depend on the eptions installed in the analyzer. 


appear. 


Also, if the step attenuetor option is not installed, these keys will not 
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SCPI Commands 
KEYSTROKES SCPI COMMAND 
SWEEP 
Sueep Time ENTER SENS [1|2]:SWE: TIME <num> 


Sweep. Time AUTO man 


Alt Sveep oo: OFF 2 


Frequency Sweep. 


Power Sweep 


[aslfs|ps|nslusims|s]+;*WaT 


SENS [112] :SWE: TIME: AUTO <ON| OFF>; *WAI 


SENS: COUP <HONE| ALL>;*WAI 


POW: MODE: FIX; *WAT 


POW: MODE: SWE; *WAT 


1 If using the microsecond suffix (us", the lerter “u” must be used. Do not use the Greek character ee 
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SCPI Commands 


KEYSTROKES 


SCPI COMMAND 


MENU 
Trigger 
Continuous 


Hol 


Trigger Source 


intern 


External Sveep 


External Point 


Number of Points: ENTER 


Distance 1 

Start Distance ENTER 
Stop Distance ENTER 
Feet 


Meters. 
SRL Cable Scan! 


Ext Ret on OFF 


ABOR; : INIT[1!2]: CONT ON; *Wat 
ABOR; : INIT[1{2]: CONT OFF;*Wal 
ABOR;:INIT(1]2]:CONT OFF; :INIT[1/2] ;*WAI 


TRIG:SOUR IMM; :SENS: SWE: TRIG: SOUR 
THM; #WAT 


TRIG:SOUR EXT; :SENS: SWE: TRIG: SOUR 
IMM; #WAT 


TRIG:SOUR EXT; :SENS:SWE:TRIG:SOUR 
EXT; #WAr 


SENS (1!2]:SWE:POIN <num>;*WAT 


SENS({41]2]:DIST:STAR <num> [FEET{|MET] ; #WAI 
SENS [1 [2] :DIST:STOP <num> [FEET|HET];*WAT 
SENS : DIST: UNIT FEET 
SENS: DIST: UNIT MET 


SENS [112] :FUNC:SRL: SCAN; *WAr 


SENS:ROSC:SOUR <EXT|INT>;*WAI 


1 Option 100 only 
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Menu Map with SCPI Commands 


SCP! Commands (continued) 


KEYSTROKES 


SCPE COMMAND 


Spur Avoid Uptions 


flone DIAG: SPUR: METH WONE;*WAT 
Dither DIAG: SPUR: METH DITH;*WAT 
Spur Avoid DIAG: SPUR: METH AVO;*WAI 
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Menu Map with SCP Commands 


SCPI Commands 
KEYSTROKES SCPI COMMAND 
SCALE 
Autoscale DISP: WIND [1/2/10]: TRAC: Y: AUTO ONCE 
Scale/Div (Number) (ENTER DISP: WIND[1!2]:TRAC:Y:PDIV <num> 
Reference Level ENTER DISP: WIND [112]: TRAC:Y:RLEV <num> 
Reference Position Number) (ENTER DISP: WIND[1|2]:TRAC:Y:RPOS <num> 
oft DISP: WIND: TRAC[i12]:Y:TRACK <OFF> 
Track Peak DISP:WIND:TRAC[112]:Y:TRACK PEAK 
rack Frequency DISP: WIND: TRAC [1|2]:Y:TRACK FREQ 
Set track ‘Frequency 
(Number) Units. DISP: WIND: TRAC(112]:¥:TRACK <num> 
(az 1Kaz 182] 
: ENTER SENS(1/2]:CORR:OFFS:PHAS <num> [DEG] 
ay (Number) (ENTER SEWS[112]:CORR:EDEL: TIME <num> 
[as|fs{psinslus{ms|s]? 


1 If using the microsecond unit terminator, the letter “u” must be used. Do not use the Greek character “ys.” 
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SCPI Commands 


Menu Map with SCP! Commands 


KEYSTROKES 


SCPi COMMAND 


MARKER 


4: or i> 


Units 


25 or 2> 


St 


Units 


or 3> 


(@umber} Units 


ae) or a> 


init 


Hore Markers 


See or b> 

Units 
6: or 6> 

Units 
Cap or (> 

Units 
Bt or B> 

unde 


Active Marker Ort 


CALC[1}2] 


CALCL112] 
caLc[4[2] 


CALCL1[2] 
CALC[ 412] 


CALC[1 12] 
caLclil 2] 


cCALc[112] 
CALC[112]: 
cCaLCEil2]: 


CALC[12] 
caLClil2] 
CALC[112] 
cALcfil2] 
caLc{il2] 


cALcfil2] 


CALCLil 2]: 


MARK1 ON 


:MARK1i:X <num> [MHZ |KEZ[HZ] 


:MARK2 OW 
:MARK2:X% <num> [MHZ |KHZ1HZ) 


:MARK3 OW 
:MARK3:X <num> [MHZ|KHZ|HZ] 


:MARK4 OW 
:MARK4:X <num> [MHZ |KHZ/22Z] 


:MARKS OW 
MARKS:X <num> [MHZ|KHZ1#Z) 


MARK6 OW 


:MARK6:X <num> [MHZ|KHZ18Z] 
:MARK7 OW 
:MARK7:X <num> [MHZ|KHZ1HZ) 
:MARKS OW 
:MARK8:X <num> (MEZ|KHZ/#Z] 


:MARK[112{.-8] OFF 
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Menu Map with SCP| Cammands 


SCPI Commands (continued) 


ay 
KEYSTROKES _ SCP COMMAND 
ALL oft | CALG [4 12] : MARK: AGFF 
Marker Functions 
Delta Mur on OFF CALC[112] :MARK:MODE <REL|ABS> 
Marker —> Center SENS [1 [2] :FREQ: CENT 
(CALC[1127:NARKE1I2| ... 8]:X:ABS?);#WAI 
Marker —> Reference DISP:WIND [412] : TRAC: Y:RLEV 
(CALCL4112]:MARKCil21 ... 8] :¥?);*WAI 
@ Marker —> Elec Delay SEWS [112] : CORR: EDEL: TIME 
(CALCEL}27:MARK(112] ... 8]:GDEL?) ;*WAT 
Marker Hath 
Statistics CALC[112] :MARK:FUNC STAT 
Flatness CALC[112]:MARK:FUNC FLAT 
RF Filter Stats CALC [112] :MARK:FUNC FST 
Math Off CALC[1|2] :MARK:FUNC OFF 
Marker Search 
ax Search CALC[112] :MARK:FUNC MAX 
Mer —> Max CALC[1{2] :MARK:FUNC MAX 
Next Peak Let CALCE1 12) :MARK: MAK: LEFT 
CALCL4 12] : MARK :MAX: RIGH 
CALCL1[/2]: MARK: FUNC MIN 
i CALCE112] :MARK:FUNC MIN 
Hlext Hin Lett CALCE1/2] : MARK: MIN: LEFT 
Next Min Bight CALCE1|2] : MARK: MIN: RIGH 
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(MARKER)}SCPI Commands (continued) 


Menu Map with SCPI Commands 


KEYSTROKES 


SCPI COMMAND 


Target: Search 


Target Value ENTER 


Search left ENTER, 
Search right 


Bandwidth 
Fotch 
(ENTER), 
Hore 
Multi Peak 
MultiNotch 
Search Off 


Tracking on OFF 


CALC {1 


CALC[1 
[DB] 


CALC[1 
CALCE4 
CALCLA 
CALCEAL 
CALCL4 
CALCLA 


CALC{4 
CALC[4 
caLc(t 
CALC[1 


2] 
2] 


2] 
2] 
2] 
2a 
2] 
2] 


2] 
2] 
2] 
2] 


sMARK: 
MARK: 


: MARK: 
i MARK: 
: MARK: 
: MARK: 
: MARK: 
: MARK: 


: MARK: 
: MARK: 
: MARK: 
: MARK: 


FUNC 
TARG 


TARG 
TARG 
FUNC 
BWID 
FUNC 
NOTC 


FUNC. 


FUNC 
FUNC 


FUNC: 


TARG 
<LEFT | RIGH> ,<num> 


LEFT,<num> [DB] 
RIGH,<num> [DB] 
BWID 

<num> [DB] 

NOTC 

<num> [DB] 


MPE 
MNOT 
OFF 
TRAC <ON|OFF> 
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Menu Map with SCP! Commands 


SCPI Commands 


KEYSTROKES SCPI COMMAND 
DISPLAY. 
Normalize TRAC CHL1!2]SMEM,CH[1|2]SDATA; 
:CALC[4 12] :MATH (IMPL/CH [112] SHEN) ; 
:DISP: WIND [1]2]:TRAC1 ON; TRAC2 OFF 
Data Men TRAC CH[i|2]SMEM,CH[1/2]SDATA 
Data CALC[1]2]:MATH CIMPL); 
:DISP:WIND[112]:TRAC1 ON;TRAC2 OFF 
Memory DISP:WIND[112]:TRAC1 OFF;TRAC2 ON 
Data/Mem CALCE1|2]:MATH (IMPL/CH[112]SMEM); 
:DISP:WIND [1/2]: TRAC1 ON; TRAC2 OFF 
Data and Menory CALCE1{2]:MATH (IMPL); 
:DISP:WIND[112]:TRAC1 ON; TRAC2 ON 


Limit dent CALCL1/2]:LIN:DISP ON 


CALCL112] :LIM:SEGN(4 [21-12] :TYPE LMAX; 
STAT OW 
CALCLL 121 :LIM:SEGN(1|2]--12] TYPE LMIN; 
STAT OW 
Add Wax Point CALCL112] :LIM:SEGH (1121-121 :TYPE PHAZ; 
STAT OW 
Add Win Point CALC (1 [2] :LIM:SEGH[1|2|--12]: TYPE PEIN; 
STAT OW 
Delete Limit CALC(1 12] :LIM:SEGM(412|--12]:STAT OFF 
Delete All Limits CALC [112] :LIM:SEGM: AOFF 


11-18 


Menu Map with SCPI Commands 


SCPI Commands (continued) 


KEYSTROKES 


SGP COMMAND 


Edit Limit 


Begin Frequency ENTER 
End Frequency ENTER. 
Begin Limit ENTER 


End Limit ENTER 


Marker 


Limit Line QU off 

Limit Text OK off 

Limit Icon ON off 

Limit Icon X Position 

Limit Icon ¥ Position 
Hikr Limits 


Max Limit ENTER 
Min Limit ENTER 
Mer Limit ON off 


Limit Test on OFF 


CALC[1|2] : LIM: SEGM[1]2[---12] :FREQ:STAR 
<num> [MHZ|KHZ|HZ] 


CALC[1[2] :LIM: SEGM([1]2]---12]: FREQ: STOP 
<num> [MBZ|KH2(HZ] 


CALC(1] 2] :LIM: SEGM([1|2]--12]:AMPL: STAR 
<num> 


CALC[1] 2] :LIM: SEGM[1|2[---12]: AMPL: STOP 
<num 


CALC[1]2] :LIM:DISP <ON|OFF> 
DISP: ANN: LIM: 1COW(1]2]: TEXT <ON | OFF> 
DISP: ANN: LIM: ICOW[1|2]:FLAG <ON|OFF> 
DISP: ANN: LIM: ICON(1|2]:POS:X <num> 
DISP:ANN:LIM: ICOW[i1[!2]:POS:Y <num> 


CALC[1[ 2] :LIM: MARK: STAT 
:<HEAN| PEAK|FLAT|TILT|FREQ>:MAX <num> 


CALC [112] : LIM: MARK: STAT 
:<MEAN|PEAK| FLAT|TILTIFREQ>: KIN <num> 


CALC[1| 2] : LIM: MARK: STAT 
:<MEAN| PEAK|FLAT|TILTIFREQ> <OW | OFF> 


CALC[1/2] :LIM:STAT <ON|OFF> 
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Menu Map with SCPI Commands 


SCPI Commands (eantinued) 


[pIsp: 


= —<— 
KEYSTROKES SCPI COMMAND 
More Display 
Split Display FULL Split DISP:FORM [SING|ULOW] 
Expand on OFF DISP:FORM:EXPAND <ON|OFF> 
Le and Clock 
Enter Line 1 DISP:ANN:TITL1:DATA <string> 
Enter Line 2 DISP: AWN: TITL2:DATA <string> 
Show Clock on Line 1 DISP:ANN:CLOC:MODE LINE 
Show Clock on Line 2 DISP:ANN:CLOC:MODE LINE2 
Clock Off DISP:ANN:CLOC:MODE OFF 
Title + Clk ON oft DISP: ANN: TITL <ON|OFF> 
Color Options 
Factory Default DISP: CMAP :SCHEME DEF 
Default 2 DISP: CMAP: SCHEME DEF2 
Grey Scale DISP:CMAP:SCHEME GREY 
Inverse Video DISP:CMAP:SCHEME LEV 
Custom Colors: DISP: CMAP: SCHEME CUST 
Select Item 
Hue, Saturation, Luminance |DISP:CMAP:COL[1/2] ... 16]:HSL 
<num> , <num> ,<num> 
Int Disp Intensity CMAP: COL[1121 ... 16]:GREY <num> 


1 Where <num>,<num>,<num> represents values for hue, saturation, and luminance, respectively. Accepted values for each parameter are 0 to 1. 
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Menu Map with SCPL Commands 


SCP! Commands (continued) (continued) 


KEYSTROKES 


SCPi COMMAND 


Annotation: Options 
Meéas. Annot-ONvoff 
Freq Annot ON off 
Mkr Annot ON off 
Mkr NumbexON off 
Y-Axis Lb1 ON off 
YoAxis Lbl rel ABS 


Graticule ON off 


DISP: 
DISP: 
DISP: 
DISP: 
DISP: 
DISP; 
DISP: 


ANN: CHAN[1/2] <ON|OFF> 

ANN: FREQ(112] <ON|OFF> 

ANN: MARKC1!2] <ON | OFF> 

ANN: MARK[i12]:NUMB <ON|OFF> 

ANN: YAX <ON|OFF> 

ANN: YAX:MODE <REL|ABS> 

WIND [1/2]: TRAC:GRAT:GRID <ON|OFF> 
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Menu Map with SCPI Commands 


SCPI Commands 
KEYSTROKES SCPI COMMAND 
FORMAT 
Log Mag CALC[1|2] :FORN MLOG 
Lin Mag CALC(1!2]:FORM MLIN 
SUR CALC[1|2]:FORN SWR 
@ Delay CALCLi12]:FORN GDEL 
@ Phase: (CALC[1/2] :FORM PHAS 
@ Smith Chart CALC[1 12] :FORM SMIT 
® Polar CALC[1|2]:FORM POL 
More Format 
&® Real CALC(1/2]:FORM REAL 
& imaginary CALC[1121:FORH IMAG 
@ Impedance Magnitude CALC{112] :FORH MIMP 
Mag Units 
log Mag Units CALC: FORM: UNIT : MLOG 
<DBW|DBM| DBUW | DBV| DBMV | DBUV> 
lin Mag Units CALC:FORM:UNIT:MLIE <W{ MWIUWIV|MY[UY> 
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Menu Map with SCP! Commands 


SCPI Commands 


KEYSTROKES 


a, 


SCPI COMMAND 


CAL 
Transmission mode: 
Restore Defaults 


Response 
Measure Standard 
Response & Isolation 


Measure Standard. — loads 


Measure Standard — Through 
Enhanced Response 


Heasure Standard’: — Open 
Heasure Standard. — Short 
Heasure Standard — load 
andard: — Through 


SENS [1|2]:CORR:CSET DEF; +*WAr 


SENS[1|21:CORR:COLL: IST OFF; NETH 
TRAW1; *WAI 


SENS [1/2]: CORR: COLL STAN1;*WAL; 
rSENS (1 12]: CORR: COLL: SAVE; *WAl 


SEUS[1[2] :CORR:COLL:IST OFF; METH 
TRAN; *WAI 


SEWS[1]2]:CORR:COLL STAN; *WAT; 


SENS[112]:CORR:COLL STAN2;*WAZ; 
SENS [112] :CORR: COLL: SAVE; *WAI 


SEWS [1] 2] :CORR: COLL: IST OFF; RETR 
TRANS ; WAL 


SENS[1/2]:CORR:COLL STAN1;+WAI 
SENS[112] :CORR:COLL STAN2;+WAl 


SENS[1{2] :CORR:COLL STAN3;+*WAT 


SEHS[1/2] :CORR:COLL STAN4;*WAT; 
:SENS [1 [2]: CORR: COLL: SAVE; #WAI 
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Menu Map with SCPI Commands 


SCPI Commands (continued) 


KEYSTROKES SCP} COMMAND 
a 
Transmission made (continued): 
Pest Set cal! SENS [1] 2] : CORR: TESTSET; #WAI 
Create “TSET_CAL" SENS [1]2]:CORR:COLL: METHOD TEST; 
a2 Ports 2 SENS [4] 2] : CORR: COLL: PORTS 


<2/4/6/8[10] 12> 


Measure Upens SENS [1] 2] : CORR: COLL: MP: OPEN 
<STANA|STAN2| ... |STAN12>;*WAI; 
Measure Shorts: SENS [112]: CORR:COLL: MP: SHORT 
<STAN1/STAN2| ... [STAH12>;*WAI; 
Measure Loads SENS (1[2]: CORR: COLL: MP: LOAD 
<STAN1|STAN2] ... |STAN12>;*WAT; 
Measure Thrus SENS [1]2] : CORR:COLL: MP: THRU 
<STAW4|/STAN2| ... [STAHG>;*WAT; 
#11 Stds Done SENS [4]2] : CORR: COLL: SAVE; *WAI; 
Abort Cal SENS [1!2] : CORR: COLL: ABORT 
Periodic SelfCal_ CAL:SELF <ON|OFF> 
SelfCal Once CAL:SELF ONCE 
SelfCal Timer. CAL: SELF: TIMER <num> 
SeifCal All Ports CAL: SELF: ALL 


1 For use with HP 87075C multiport test sets only 
2 XX-=number of parts 
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Menu Map with SCPI Commands 


SCPI Commands (continued) 


KEYSTROKES I SCP COMMAND 
Transmission made (continued): 
CAL Check 
Do CAL Check SENS [1]2]:CORR:COLL: IST OFF; METH 
VERIFY; *WAl 
Measure Standard SEWS [41] 2] :CORR: COLL: VER: [TRAN] REFL] 
<STABL{STAN2| ... {STAN12>;*WAT; 
AbOrT. CAL Check SENS [1/2]: CORR: COLL: ABORT 
View Cal Check 
Directivity. DIAG: MDIS[1|2]:CORR C_DIRECT;*WAI 
Source Match DIAG: MDIS[1|2]:CORR C_SRCMATCH; #WAI 
Reflection Tracking DIAG: MDIS[1/2] :CORR C_LRTRACKING ; *WAI 
Load Hatch DIAG: MDIS[1|2] :CORR C_LDMATCH; *WAI 
Transmissn ‘Tracking: DIAG: MDIS[1/2] :CORR C_TTRACKING; *WAI 
Isolation DIAG: MDIS[1/2] :CORR C_ISOLATION; WAI 
Restore Neas DIAG: MDIS(1|2] :REST; #WAI 
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Menu Map with SCPI Commands 


SCP Commands (continued) 


KEYSTROKES SCP! COMMAND 
et 
Reflection made: 
Restore Defaults SENS[112]:CORR:CSET DEF; +WAZ 
One Port SENS [112] :CORR:COLL:IST OFF;METH REFL3; 
*Wal 
Measure Standard: — Open SENS [1{2]:CORR: COLL STAN1;*WAI 
Measure Standard ~ Short SENS [112]: CORR:COLL STAN2;*WAI 
Heasure Standard — iad SENS [112] :CORR:COLL STANS;+WAT; 
SENS [112] : CORR: COLL: SAVE; *WAI 
Test Set Cal SEWS [112] : CORR: TESTSET; *WAI 
Create “‘ISET_CAL" SENS [1{2]:CORR:COLL:METHOD TEST; 
XX Ports? SENS [112] :CORR: COLL: PORTS 
<2141618/10[12> 
Measure. pens SENS [112]:CORR: COLL: MP: OPEN 
<STAN4|STAN2{ ... |STAN12>;*WAT; 
Measure Shorts SENS [112] :CORR: COLL: MP: SHORT 
<STAN1ISTAN2| ... |STAN12>;*WAI; 
Measure Loads SENS (1 [2] :CORR: COLL: MP: LOAD 
<STAN4|STAN2| ... |STAN12>;*WAT; 
Measure Thrus SENS [112] :CORR: COLL: NP: THRU 
<STAN1|STAN2| ... |STAN6>;#WAI; 
ALL Stds Done SENS [1/2] :CORR: COLL: SAVE; #Wal; 
Abort Cal SENS [42] :CORR:COLL: ABORT 
Periodic SelfCal CAL: SELF <OW|OFF> 
Selfcal Once CAL:SELF ONCE 
SelfCal Timer CAL: SELF: TIMER <num> 
|___ Selteat “ALL Ports CAL: SELF: ALL 


1 For use with HP 87075C multipart test sets only 
2 XX«number af poris 
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Menu Maa with SCP! Commands 


(CAL) SCPI Commands (continued) (continued) 


KEYSTROKES SCPI COMMAND 
Reflection mode (contiaued): 
CAL Check 
Do CAL Check SENS [1|2] :CORR: COLL: IST OFF; NETH 
VERIFY ; *#AI 
Measure Standard SENS[1|2] :CORR: COLL: VER: CTRAN| REFL] 
P <STAN1|STAN2|] ... |STAN12>; *WAI; 
Abort CAL Check SENS [112] :CORR:COLL: ABORT 
View CAL Check 
Directivity DIAG:MDIS[1{2]:CORR C_DIRECT;*WAI 
Source Match DIAG:MDIS[1|]2]:CORR C_SRCMATCH; #¥AI 
Reflection Tracking DIAG :MDIS[1/2]:CORR C_RTRACKING;*WAL 
Load Watch DIAG:MDIS[1!2]:CORR C_LDMATCH; *WAI 
Transmissn Tracking DIAG:MDIS{112]:CORR C_TTRACKING; *WAI 
Isolation DIAG:MDIS[1/2]:CORR C_ISOLATION;*WaI 
Restore Meas DIAG: MDIS[1|2] :REST;*WAI 
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Menu Map with SCPI Commands 


SCPI Commands (continued) 


KEYSTROKES SCP] COMMAND 
Fault Location mode:* 
Default Cal SENS [1|2]:CORR: CSET DEF; *WAT 
Full ‘Band Cal SENS [1{2]:CORR: COLL: IST ON;METH REFL3; 
¥WAT 
Measure Standard — Open SENS [112]:CORR:COLL STAN1; *WAI 
Measure Standard — Shor SENS[1]2]:CORR:COLL STAN2;*WAI 


Meastire Stand: SENS[1[2]:CORR:COLL STANS;*WAT; 


SENS [112] : CORR: COLL: SAVE ; *WAL 
Velocity. Factor. SEWS [112] :CORR:RVEL: COAX <num> 
Cable Loss SENS [1]2]:CORR:LOSS:COAX <num> 
Calibrate Cable 


Specify Length. SEWS [112]: CORR:LENG:COAX <num> 
[FEET | MET] ; *WAT 
Measure Cable SENS [1] 2] :CORR:RVEL; *WAI 


SENS [1|2]:CORR:PEAK:COAX [ON|OFF] 


SENS [112] :CORR: THR: COAX <num> 


Connector Values, 


Connector Length SENS [412]:CORR:LENG:CONN <num> 
Connector ¢ SEWS[1|2]:CORR:CAP:CONN <num> 


1 Option 180 only 


Menu Map with SCP! Commands 


SCPI Commands (continued) 


KEYSTROKES SCPI COMMAND 

SRL mode: 

Default Cal SENS[1|2]:CORR:CSET DEF; *WAT 

Pull Band: Cal SEWS[1|2]:CORR:COLL: IST ON;METH REFL3; 

*WAT 

Measure ‘Standard: — Open SENS[112]:CORR:COLL STANL;+#WAI 
Measure Standard: — Short SENS(1[2]:CORR:COLL STAN2;+#WAL 
Measure Standard — toad SENS[112]: CORR: COLL STAN3;+WAT; 


:SENS [1/2] :CORR: COLL: SAVE; #WAI 
Connector Model 


Measure Connector 


Measure SENS[14| 2]: CORR: MODEL: CONN 
Connector Length SENS([1|2]:CORR:LENG: CONE <num> 
Connector ¢ SENS[1{2]:CORR:CAP: CONN <num> 
2 cutott Frequency SENS[1{27:FREQ:ZST <num> 
[GH2 | MHZ |KH2|82Z) 
Auto Z ON off SEWS[1|2]:FUNC:SRL:MODE [AUTO| MAW] | 
Manual Z SENS[4|2] :FUEC:SRL: IMP <num> 
AM Delay mode:” 
Restore Defaults SENS[1]2]:CORR:COLL: IST OFF;NETH 
TRAN1; *WAI 
Response SENS[1]2]:CORR:COLL:IST OFF; NETH 


TRAN ; #WAL 


Measure Standard SENS[1|2]:CORR:COLL STAN1;#WAT; 
:SENS [1|2] :CORR:COLL: SAVE; #WAI 


1 Option 188 only. 
2 Cptions 1DA and 1D8 only 
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Menu Map with SCP] Commands 


SCPI Commands {continued} 


KEYSTROKES 


SCPI COMMAND 


Cal Kit 
Detauit Type-i(t) 


Type-N(m): 


User Detined 
3-5 mm! 
Type-F 7 
System 20 
ae8 
Tp o 


Power mode, Conversion Less mode, broadband detection modes: 


dutozera 


Manual Zero 
Unraticed narrowband internal measurements: 


Hormal ze 


SENS :CORR:COLL:CKIT ’COAX,7NM,TYPE- 
N,50,FEMALE’ 

SENS :CORR: COLL: CKIT 

COAX, 7HM,TYPE~",75,FEMALE? (Option 1EC) 


SEWS:CORR:COLL:CKIT ’COAX,7NM, TYPE- 
N,50,MALE? 

SENS : CORR: COLL: CKIT 

> COAX, 7MM,TYPE-H,75,MALE’ (Option 1EC) 


SENS :CORR: COLL: CKIT 
USER, IMPLIED ,IMPLIED, IMPLIED , IMPLIED’ 


SENS :CORR: COLL: CKIT 
COAX, 3.5MM,APC-3.5,50, IMPLIED’ 


SENS : CORR: COLL: CKIT 
?COAX,7MM,TYPE~F 75, IMPLIED’ 


SENS [112]:CORR:IMP:INP:MAGN:SEL ZO_50 
SENS [1/2]:CORR:IMP:I¥P:MAGN:SEL Z0_75 


CAL: ZERO: AUTO ON; *WAL 
CAL: ZERO: AUTO ONCE; *WAT 


TRAC CHE11QISMEM,CH[1|2]SDATA; 


:CALC([1|2]:MATH CIMPL/CH[1]2]SMEM) ; 
:DISP:WIND[1]2]:TRAC1 ON; TRAC2 OFF 


1 50Q systems only 
2 75Q systoms only 
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Menu Map with SCP! Commands 


SCPI Commands (continued) 


KEYSTROKES 


SCPI COMMAND 


os 


© More Cal 


& Velocity Factor 
@ Smith chart Zo ENTER 


& Port Ext’s on OFF. 


@& eti Port Extension ENTER) | SENS [1] 2] :CORR:EXT:REFL:TIME <num> 


& France Port Extension (Number) (ENTER)| SENS [112] :CORR:EXT: TRAN: TIME <num> 


SENS [1]2] :CORR:RVEL: COAX <num> 
SENS(112] :CORR:IMP:INP:MAGH <num> [OHM] 


i 
SENS (1]2]:CORR:EXT [ONIOFF] 


[aslis|psinslus|msts]! 


[aslfsipsinslusims|s]* 


1 Hf using the microsecond unit terminator, the letter “u" must be used. Do not use the Gresk character “.” 
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Menu Map with SCP| Commands 


SCPI Commands 
KEYSTROKES SCPI COMMAND 
a 

Average on OFF SENS [1|2] :AVER <ON|OFF>;+*WAI 
Restart Average SENS [1[2] : AVER:CLE; *WAT 
Average Factor ENTER SEWS([1127:AVER:COUN <num>;+WAI 
System Bandsidth 

Wide SEWS[112]:BWID 6500 HZ;#WAI 

Med Wide SENS[1|2]:B¥ID 4000 HZ;#WAT 

Medium SENS(1[2]:BWID 3700 3Z;*WAT 

Wed Narrov SENS[41]2]:BWID 1200 HZ;*WAI 

Narrow SENS([1|2]:BWID 250 HZ;*WAI 

Fine SENS[1]2]:BWID 15 EZ;#WAI 
Fault Window * 

Minimum SENS{1|2]:WIND RECT 

Medium SENS(1|2]: WIND HANH 

Maximum SEMS[1|2]:WIND KBES 
®@ Delay Aperture 

® Aperture (dz) ENTER CALC[112]:¢DAP:SPAN <num> [HZ] ; *WAT 

® Aperture (4) ENTER CALCL1[2]:GDAP:APER <num>;*WAI 


1 Option 180 only 
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®& indicates HP 8712C/14€ only 


Menu Map with SCPI Commands 


SAVE RECALL ) SCPI Commands 


KEYSTROKES SCPI COMMAND 
SAVE RECALL 
Save State MMEM:STOR:STAT 1,<file>? 
Re-Save State MMEM:STOR:STAT 1,<file>* 
Define Save 
Inst State ON off MMEM: STOR: STAT: IST <ON|OFF> 
Cal on OFF MMEM:STOR:STAT:CORR <ON| OFF> 
Date on OFF MMEM: STOR: STAT: TRAC <ON | OFF> 
PSet Cal on OFF MMEM: STOR: STAT: TSCAL <OW|OFF> 


File Format 


GP B7114/B Compatible MMEM: STOR: STAT:FORM BP87112 


HP 8711C Compatib: MMEM: STOR:STAT: FORM HP8711C 


Save ASCIT 


MMEM: STOR: TRAC: FORM LOT 
I mat NMEM: STOR: TRAC: FORM TOUC 

Save Meas 1 MMEM:STOR: TRAC CHIFDATA,<file>! 
Save Meas 2 MMEM:STOR: TRAC CH2FDATA,<file>! 


Recall State HMEM:LOAD:STAT 1,<file>? 


1 <file> may include the mass storage device mnemonic MEM:, INTE, or RAM: before the actual name of the file. If the mass sterage device is not explicitly 
named the currently selected device is assumed. <file>, <filel> and <file2> are <string> parameters. <string> parametels appear between single 
quotes, 
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SCPI Commands (continued) 


KEYSTROKES SCPI COMMAND 


MNEM:MSIS ’MEM:’ 
MMEM:MSIS *RAM:? 


MMEM:MSIS ’INT:’ 


Configure VOL_BAR 


Restore Defaults No SCPI command 
Modity Size No SCP! command 
Current Size. Ne SCP! command 


1 The (BASIC menu is described under the SYSTEM OPTIONS koy 


Menu Map with SCP] Commands 


SCPI Commands (continued) 


KEYSTROKES 


SCPI COMMAND 


File Utilities? 


Renae File 

Delete File 

Delete All Files 

Copy File 
Copy to NonVol Ran 
Copy to Vol RAM 


Copy to.3.5" Int Disk 


Copy All Files 
Copy. to NonVol Bail 
Copy to Vol RAM 
Copy to 3.5% Int Disk 
Format Disk 
Format NonVol RAM: 
Format Vel RAN 


Format 3.5" Disk 


MHEM: MOVE 


<filel>,<file2> 


MMEM:DEL <file> 


MMEM:DEL ?*.*? 


MMEM: COPY 
MMEM: COPY 
MMEM: COPY 


MHEM: COPY 
MMEM: COPY 
MMEM: COPY 


MMEM: INIT 
MMEM: INIT 
MMEM: INIT 


<filei>,<?HEM:file2’> 
<filei>,<?RAM:file2’> 


<filei>,<’INT:f£ile2’> 


te *? MEM: 7 
tele? TRAM:? 


ree? INT? 


7HEM:’ 
*RAM:’ 
?INT:" 


1 Previous models of this analyzer may have supported LIF format. This version only supports DOS. 


2 <file> may include the mass storage device mnemonic MEM:, INT:, or RAM: before the actual name of the file If the mass storage device is not explicitly 
named the currently selected device is assumed. <file>, <file1> and <file2> are <string> parameters. 
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Menu Map with SCP! Commands 


SEPI Commands (continued) 


KEYSTROKES SGP! COMMAND 
Directory: Utilities 
Change Directory MMEM:CDIR <directory> 
Make. Directory. MMEM:MDIR <directory> 
Remove Directory. MMEM:RDIR <directory> 
FastRecali on OFF DISP:MENU:REC:FAST <ON|OFF> 
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SCPI Commands 


KEYSTROKES 


SCP] COMMAND 


HARD COPY 
Start 


Abort 


Select Copy Port 
Restore Defaults 


Select: 


LAN Printr IP Addr 

Printer: Address 
Baud: Rate 
Son/Kofi 

DTR/DSR 


Define PCLS 
Restore Defaults 
Monochrome 
Color 
Auto Feed ON off 
Portrait 


Landscape 


HCOP ; *WAT 


HCGP : ABOR 


No SCPi Command 


HCOP:DEV:LANG <PCL|EPGL|IBM|EPSON | PCX>; 
PORT <CENT|SER|GPIB|MMEM|LAN> 


SYST: COMM: LAN:PRIN: HOST <string> 
SYST: COMM: GPIB: HCOP: ADDR <num> 
SYST: COMM: SER: TRAN: BAUD <num> 
SYST: COMM:SER: TRAN: HAND XOW 
SYST: COMM: SER: TRAN: HAND DTR 


No SCPI Command 

HCOP:DEV3:COL OFF 
HECOP:DEV3: COL ON 

HCOP: ITEMS: FFE:STAT <ON|OFF> 
HCOP:DEV3:PAGE:ORI PORT 


HCGP :DEV3: PAGE: ORI LAND 


11-37 


Menu Map with SCP] Commands 


SCPI Commands (continued) 


KEYSTROKES 


ScPi COMMAND 


‘More: PCLS 
Restore Defaults 
Top Margin 
Left Margin 
print widily Samba) 


Detine Printer 

Restore Defaults 

Monochrome 

Color 

Portrait 

Landscape 

Auto Feed OH off 

More Printer 
Restore Defaults 
Printer Resolution 
Top Margin 
Lede Maxgi 
Print Width 


Define Plotter 
Restore Defaults 7 
Monochrome 


Color. 


No SCP! Command 

HCOP: DEV3:PAGE:MARG:TOP <num> 
HCOP : DEV3:PAGE:MARG:LEFT <num> 
HCOP:DEV3:PAGE:WIDT <num> 


No SCP| Command 

HCOP :DEVi:COL OFF 

HOOP: DEV1:COL OW 
HCOP:PAGE:ORI PORT 
HCOP:PAGE:ORT LAND 

HCOP: ITEM1:FFE:STAT <ON|OFF> 


No SCP! Command 


HCOP:DEV:RES <num> 
HCOP:PAGE:MARG:TOP <num> 
HCOP: PAGE: MARG: LEFT <num> 
COP: PAGE:WIDT <num> 


No SCPI Command 
HCOP :DEV2:COL OFF 
HCOP:DEV2:COL OW 
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SCPI Commands (continued) 


KEYSTROKES SCPI COMMAND 


Set Pen: Numbers 
Monochrome Pen No SCP Comman 
Default Pen Colors No SCPI Command 
Trace 1 Pen No SCPi Comman 
Trace 2 Pen (Number) (ENTER) No SCPI Comman 
Memory: 1 Pen No SCPI Command 
Memory (2 Pen No SCPI Comman 
Graticule Pen No SCPI Comman 


Graphics ‘Pen ENTER, No SCPI Command 
Auto Feed on OFF HCOP:ITEM2:FFE:STAT <ON|OFF> 


Define Hardcopy 


Restore Defaults No SCPI Command 

Graph and War Table HCOP:DEV: MODE GMAR 
Graph Oaly HCOP:DEV:MODE CRAP 
kr Table Only RCOP:DEV:MODE MARK 
List Trace Values HCOP:DEV:MODE TABL 


Define Graph 


Restore Defaults No SCPI Command 

Trace Data ON. off HCOP: ITEM: TRAC: STAT <ON|OFF> 
Graticule ON off HCOP:ITEM:GRAT:STAT <ON| OFF> 
Annotation ON. off HCOP: ITEM: ANN: STAT <ON|OFF> 
cr Symbol OM off ECOP:ITEM:MARK:STAT <ON|OFF> 
Title + Clk OW off HCOP: ITEM: TITL:STAT <ON|OFF> 
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SCPI Commands 
7 


KEYSTROKES 


ah 


SCP! COMMAND 


Ipasic? 
Run 
Continue 
step 
Edit 


Utilities 


Secure 


None 
Full 
Upper 


Bower. 


Key Record-on OFF 


Clear Program 


Stack Size 


TBASIC Display 


PROG:STAT RU 
PROG:STAT CONT 
PROG:EXEC ’STEP’ 
No SCP Command 

No SCP] Command 


PROG: DEL 
PROG: MALL <size> 
No SCP Command 


DISP:PROG OFF 
DISP: PROG FULL 
DISP:PROG UPP 
DISP:PROG LOW 


1 Optian 1C2 only 
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Menu Map with SCP! Commands 


SCPI Commands (continued) 


KEYSTROKES SCPI COMMAND 
La? 
LAN State on OFF SYST: COMM:LAN:STAT <ON|OFF> 
LAN Port Setup 
HP 8714C IP Address SYST: COMN:LAN:IPAD <string> | 
Gateway IP. Address SYST: COMM:LAN:ROUT:GAT <string> 
Subnet Mask SYST: COMM:LAN:ROUT:SMAS <string> 


Diagnostic Utilities 


IP Address to Ping DIAG: COMM: LAN:PING:IPAD <string> 
Perform Ping: DIAG: COMM: LAN : PING: IMM 
i 
Ethernet ‘Address. SYST: COMM: LAN : EADD? 


Security Setup 


HP-1B 
BP 8714c Address SYST:COMN:GPIB: ADDR <num>? 
Talker Listener SYST: COMM:GPIB:CONT OFF? 
System Controller SYST: COMM:GPIB: CONT on? 
EP-IB Echo on OFF. SYST: COMM:GPIB:ECHO <ON|OFF> 


Uperating Parameters 
Hardcopy Screen. No SCP! Command 
Hardcopy All HCOP:DEV:MODE ISET;:HCOP;+WAI 
Abort HCOP : ABOR 


1 Option 1F? only 
2 A five second delay is required before a command is sent to the new address. 


3 Far use with IBASIC running an the analyzer’s internal contraller — this command cannot be executed from an external controlie, Use *OPC? and wait for a reply 
before sending any QUTPUT Prox commands from IBASIC. 
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SCPI Commands (continued) 


KEYSTROKES SCPI COMMAND 
Systen Contig 
Set Clock 

Set Year SYST:DATE <year>,<month>,<day>! 

Set Month ENTER SYST:DATE <year>,<month> ,<day>! 

Set Day ENTER SYST:DATE <year>,<month> ,<day>? 

Set Hour ENTER SYST:TIHE <hour>,<minute>,<second>! 

Set Minute ENTER SYST: TINE <hour>,<minute>,<second>? 

Round Seconds SYST:TIME <hour>,<minute>,o! 


Clock Format 


1 <year>,<month> .<day>,<hour> ,<minute > and <secend> are all <num> parameters. ‘Also, these keys do not generate keystroke recording BASIC 
statements, 


VYYY-MM-DD | HES DISP:ANW:CLOC:DATE: FORM YMD 
MU-DD-YvvY | BHC DISP:ANN:CLOC:DATE:FORM MDY 
BDCHM-YVYY HELM DISP:ANW:CLOC:DATE: FORM DNY 
umeric DISP:ANN:CLOC:DATE:MODE NUM 
Alpha DISP:ANN:CLOC:DATE:HODE ALPE 
Seconds ON oft DISP:ANN:CLOC:SEC <ON| OFF> 
Done. : 
Beeper Volume SYST:BEEP: VOL <num>? 


2 Number is @ fraction, for example 90% would be expressed as 0.90 
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SCPI Commands (continued) 


KEYSTROKES 


SCP COMMAND 


CRT Adjust 
Restore Defaults 
Vertical Position 
Horizontal Position 
Sync Green on OFF 
Remove Pattern 
More 
Restore Defaults 
Vertical Back Porch 
Vertical Frnt Porch 
Horizontal Back Porch 
Horizental Frat Porch 
Options Setup 
User TTL Contig 


Defanit 


Switching Test Set! 
Hultiport on OFF 


Service * 


No SCPi Command 
No SCP] Command 
No SCPI Command 
No SCPI Command 
No SCPI Command 


No SCPI Command 
Ne SCP Command 
No SCPE Command 


No SCP| Command 


No SCPI Command 


SYST: COMM: TTL: USER:FEED DEFAULT 
SYST: COMM: TTL: USER:FEED KEY 
SYST: COMM: TTL: USER:FEED SWEEP 


CONT(112]:NULT:STATE <OW|OFF> 


1 For use with HP 87078C muttiport test sets only. 
2 The Service menu is described in the Service Guide. 
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12 


SCPI Command Summary 


SCPI Command Summary 


This chapter contains all of the HP-IB cormmands recognized by the analyzer 
and a brief description. <num>, <char>, <string> and <block> refer to 

the parameter type expected by the instrument as part of the cormmand. 

All coramands have both command and query forms unless specified as 
command only or query only. Unless otherwise specified, add a “2” to create 
a query from the command form. For example, the command to select the 
log magnitude format for the data displayed is CALCulate[1 [2] : FORMat 
MLOGarithmic. To query which format is active the corresponding command 
is CALCulate[1|2]:FORMat?. The response to the query is the short form 
of the mnemonic for the active format, in this example MLOG. 


The FORM column gives the parameter type returned by the instrument 

in response to a query. NR1, NR2 and NR3 refer to the different types of 
numeric data. CHAR (character data), STRING (string data) and BLOCK 
(block data) are also used to describe response types. These parameter types 
are described in the “Parameter Types” section of Chapter 10. 


Some numeric parameters may be followed by an appropriate suffix. 
Commands that accept a suffix also allow standard metric multipliers to be 
corabined with the suffix. For example, commands that set a frequency will 
accept HZ, KHZ, MHZ and GHZ. Commands that set a time will accept S, 
MS, US, NS, PS, FS and AS. Note that case is ignored. The multiplier “M” 
is interpreted as either milli or Mega, depending on context. If no suffix is 
included, the default units for the parameter are used. 


NOTE 
This SCP! command reference is also available online. [t is stored inside your analyzer in electronic 


form. To access it, you must have the LAN option (1F7). Connect your instrument to the network, * 
and access it using your Web browser. See the Gotion 1F7 User's Guide Supplement tor details. 
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ABORt 
| SUBSYSTEM COMMANDS FORM DESCRIPTION 
[apore command only | Abort and reset the sweep in progress. 
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SCPI Command Summary 


CALCulate 
SUBSYSTEM COMMANDS [ FORM DESCRIPTION 
CaLCulate[112]:DaTa?? query only | Query the formatted date wace — functionally equivalent to the 
|[suock or NAg? [command TRAC? CH<i|2>FDATA. 
CALCulate[1|2]:FORMat <char> CHAR Select the display format for the measurement data ~ choose 
from MLOGarithmic |MLINear | SWR 
or 
6S_PHASe | SMTTh| POLar |GDELay |REAL 
[IMAGinary |MIMPedance. 
CaLCulate[1]2]:FORMat:UNIT:MLIN <char> CHAR Selects linear magnitude units for Y-axis display. Choose from 
wWiMw|UW/VIMVIUV. 
CALCulate[i|]2]:FORMat:UNIT:MLOG <char> CHAR Selects log magnitude units for Y-exis display. Choose from 
DBw | DBM| DBUW| DBY |DBHV|DBUV. 
calculate [112] :GDAPerture: APERture NR3 Set the group delay aperture as a ratio of desired aperture / 
<num> measured frequency span. 
QcaLCulate [112] :GDAPerture:SPAN <num> NAB Specifies the group delay aperture in Hertz. 
CALCulate[1|2]:LIMit:DISPlay <ON|oFF>? NRI Turn an/aff display of limit lines. 
CaLCulate [112] :LIMit :MARKer: FLATness NR3 Set the maximum velue for a flatness limit test. 
:MAXimum <num> 
CALCulate [112] :LIMit:MARKer:FLATness NRB Set the minimum value for a flamess marker limit test, 
:MINimum <num> 
CALCulate[1|2]:LIMit: MARKer : FLATness NRI Turn on/off flatness marker timit test. 
:STATe <ON|OFF>? 


‘1 Refer to Chapter 6, “Trace Data Transfers,” and to the “ASCDATA and “REALDATA” example programs in Chapter 8 for more information cn this commend. 
2 The parameter type of the data is determined by the format selected — FORMat REAL uses BLOCK date, FORMat ASCii uses NRG data separated by commas. 
3 Binary parameters accept the values of 1 (on) and & (off) in addition to OR and OFF. 
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SCP! Command Summary 


CALCulate (continued) 


v2] :AMPLitude:STARt <num>! 


SUBSYSTEM COMMANDS FORM DESCRIPTION 
CALCulate [11/2]: LIMit: MARKer :FREQuency NR Sets the maximum value for delta frequency marker limit test. 
:MAXimum <num>! 
CALCulate[112]:LIMNit : MARKer :FREQuency NR3 Sets the minimum value for delta frequency marker imit test. 
:MINimum <nun>! 
CALCulate[1|2]:LIMit: MARKer :FREQuency NRI Tums delta frequency marker limit testing on or aff. 
{:STATe] <ON|OFF>? 

a 

CALCulate[1]2]:LIMit:MARKer :STATistic NR3 Set the maximum value for a statistic mean limit test. 
: MEAN: MAXimum <num> _ 
CALCulate[1|2]:LIMit :MARKer :STATistic NR3 Set the minimum value for @ statistic mean limit test. 
MEAN: MINimum <num> 
CALCulate([1|2]:LIMit :MARKer :STATistic NRI Turn on/off statistic mean marker limit test. 
:MEAN:STATe <ON|OFF>? 
CALCulate[1|2]:LIMit :MARKer :STATistic NRS Set the maximum value far a statistic peak-to-peak limit test. 
>PEAK:MAXimum <num> 
CALCulate[i|]2]:LIMit:MARKer:STATistic NR3 Set the minimum value for a statistic peak-to-peak limit test. 
:PEAK:MINimum <num> 
CALCulate[li]2]:LIMit:MARKer :STATistic NRI Turn on/off statistic peak-to-peak marker limit test, 
:PEAK:STATe <OW{OFF>? 
cCaLCulate[1|2]:LIMit:MARKer: TILT NR3 Sets the maximum value for delta amplitude marker limit test. 
:MAXimum <num> 
CALCulate[1]2]:LIMit:MARKer: TILT NR3 Sets the minimum value for delta amplitude marker limit test. 
:MINimum <num>? 
CALCulate[1|2]:LIMit:MARKer :TILT NRI Turns delta amplitude marker limit testing on or off. 
[:STATe] <ON|OFF>? 
CALCulate[1|2]:LINit:SEGMent [1/2] NR3 Set the Begin Limit for the specified limit segment. 


1. Numeric parameters may include an appropriate suffix; if no suffix is included, the defauh (HZ for frequency or $ fer timel is assumed. 


2 Binary parameters eccegt the values of 1 Ion} and O loffi in addition to GN and OFF. 
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CALCulate (continued) 
SUBSYSTEM COMMANDS FORM DESCRIPTION 
CALCulate [1] 2] :LIMit: SEGMent [112 NRS Set the End Limit for the specified limit segment. 
--12]:AMPLitude:STOP <num>? 
CALCulate [1|2] :LIMit: SEGMent : AQFF command only | Turn off all limit segments for ¢ given channel — deletes all 
segments in the channel's limit table. 
CALCulate[1|2] :LIMit: SEGHent [1]2 R3 Set the Begin Distance for the specified limit segment. (Option 
42] :DISTance:STARt <num> 100 only! 
CALCulate[i|2] :LIMit: SEGMent [112 RS Set the End Distance for the specified limit segment. (Option 
--12] :DISTance:STOP <nom>! 160 onlyi 
CALCulate [i112] :LIMit:SEGMent [1/2 R3 Set the Begin Frequency for the specified limit segment. 
|--12] :FREQuency:STARt <num>! 
CALCulate [1|2] :LIMit:SEGMent [1/2 R3 Sei the End Frequency for the specified limit segment. 
+42]; FREQuency:STOP <num>! 
CALCulate [1|2] :LIMit:SEGMent [1|2 RS Set the Begin Power for the specified limit segment. 
|+-12] :POWer:STARt <num> 
CALCulate [1|2] :LIMit: SEGMent [112 RS Set the End Power for the specified limi segment. 
+412] :POWer:STOP <num> 
CALCulate [1] 2] :LIMit: SEGMent [1/2 RI Turn on/off the specified limit segment — adds or deletes the 
+-12]:STATe <OW| OFF>? segment. 
CALCulate [1|2] :LIMit:SEGMent [1/2 CHAR Set the limit type for the specified segment, choose from 
+42]: TYPE <char> LHAX|LMIN | PMAX | PMIW (Max Line, Min Line, Max 
Point, Min Point] — sets all of the segments limit parameters 
to their default values. 
CALCulate[1|2]:LIMit:STATe <ON|OFF>? NAY Turn on/off the limit test. 
foo im g 
CALCulate [1| 2] :MARKer : AOFF command only | Turn off af markers for 2 given channel — this has the effect 
of tuming off marker functions and tracking as well. 
'CaLCulate[1| 2] :MARKer :BYIDth <aun>! N&3 Calculate the bandwidth of a bandpass filer — mum is the 
L target bandwidth {—3 for the 3 dB bendwidth}. 


‘1 Numeric parameters may include an appropriate suifix; if ae suffix is included, the default (HZ for frequency er $ for timed is assumed. 


2 Binary parameters accept the values of 1 {on} and @ loff} in addition to GN and OFF. 
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EALCulate {continued} 
| 
SUBSYSTEM COMMANDS FORM DESCRIPTION 
— 
CALCulate[1|2] :MARKer :FUNCtion query only | Query the results of the active marker function — MAX and 
:RESult? NRS[NR3, MIN return the amplitude; TARG returns the frequency; 


NB3,NR3] | BWID returns bandwidth, center frequency, Q and loss; STAT 
feturns the frequency span, the mean and standard devietion 
of the amplitude response, and the peak-to-peak ripple; FLAT 
returns the frequency span, gain, slope and flatness; and 
FSTAT returns the insertion loss and peak-to-peak ripple of 
the passband of a filter, as well as the maximum signal 
amplitude in the stopband. Refer to the “MARKERS” example 
program in Chapter § for more information. 

CALCulate[4/2] :MARKer :FUNCtion CHAR Select the active marker function ~ choose from 
[:SELect] <char> OFF | MAXimum|MINimum| TARGet | BWIDth| 
NOTChIMPEak |MEOTch|STATistics | 
FLATness|FSTATistics. | 
CALCulate[1]2] :MARKer :FUNCtion NRI Tum on/off marker function tracking. 
:TRACking <ON{OFF>? 
CALCulate [1/2] :MARKer[1|2]--8] :GDELay? query only | Returns the group delay value, in seconds, at the specified 
marker. 
CALCulate[1|2] :MARKer[1|2|--8] command only | Set the specified marker te the maximum value on the trace. 
:MAXimum 
CALCulate[1|2]:MARKer [1121-8] command only | Moves the specified marker to the next local maximum to the 
:MéXimum: LEFT . left 
CALCulate [1/2] :MARKer[1|2|..8] command anly | Moves the specified marker to the next local maximum to the 
:>MAXimum: RIGHt right. 
CALCulate [1/2] :MARKer [1121--8] command only |Set the specified marker te the minimum value on the trace. 
iMINimum 
" 
CALCulate [1/2] :MaRKer [1/2]--8] command only | Moves the specified marker to the next local minimum to the 
: MIN imum: LEFT leh. 
CALCulate [1/2] :MaRKer [1/2]--8] command only | Moves the specified marker to the next loca minimum to the 
:MINimum: RIGHt right. 


1 Binary parameters accept the values of 1 (onl and © (off) in addition to ON and OFF. 
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CALCulate (continued) 


eas 
SUBSYSTEM COMMANDS FORM DESCRIPTION =| 
CALCulate[i|2] :MARKer:MODE <char> CHAR Turn on/off delta marker state ~ choose ABSolute or 
RELative. 
ne 
CALCulate[1]2]:MARKer:NOTCh <num>? NR3 Calculate the notch width of a notch filter — num is the 
target noteh width (-6 for the 6dB bandwidth. 
CALCulate [1/2] :MaRKer [1] 21--8] NR3 Set the specified marker point. 
:POINt? 
CALCulate [i] 2] :MARKer : REFerence :X? query only | Query the frequency of the reference marker. 
i= NR 
CALCulate [1] 2] :MARKer:REFerence:Y¥? query only | Query the amplitude of the reference marker. 
NR3 
CALCulate [i] 2] :MARKer[1|2]---8] NRi Turn on/off the specified marker. 
[:STATe] <ON|OFF>* 
= 
CALCulate[1]2] :MaRKer[1!2]--8] CHAR,NRS — | Perform @ marker search for a target value — char is the 
:TARGet <char>,<num>? direction LEFT or RIGHt. 
CALCulate[1|2] :MARKer[1|2!--8]:% <num> NR3 Set the specified marker frequency for power if in power 
sweep} 
CALCulate[1|2] :MARKer[1|2|---8] :X: ABS NR? Set a marker to an absolute value (such as frequency or 
<num> $ amplitudel. The set value is not relative to a reference marker 
if one is enabled. 
L_ {fi 
CALCulate[1/2] :MARKer[1i|2]--8]:Y? query only | Query the specified marker amplitude 
NR3 
@caLculate[1|2] :MARKer [1121---8]:¥ query only ‘| Query the specified marker’s inductance when in Smith chart 
: NR3 format. 
:TWDuctance ? L 


1 Numeric parameters may include an appropriate suffix: if no suffix is included the default (HZ for frequency or S$ for time} is assumed. 
2 Refer to “Displaying Measurement Results” in Chapter 7 of the User's Guide for more information on using this command. 
3 Binary parameters accept the vaiues af 1 ton! and 0 (off! in addition to ON and OFF. 
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SCPI Command Summary 


CALCulate (continued) 
SUBSYSTEM COMMANDS FORM DESCRIPTION 

SScaLculate [1] 2] :MaRKer[1/21-.-8]:¥ query only | Query the specified marker's magnitude when in polar format. 
NR \ 

:MAGHTitude? 

calculate [1/2] :NARKer[1{2|---8]:¥ query only | Query the specified marker's phase value when in polar format.) 
NR3 

:PHASe? 

SScaLculate[i|2]:MaRKer[112]---8]:¥ query only | Query the specified marker's reactance value when in Smith 
NR3 chart format. 

:REACtance? 

SScaLculate [112] :MaRKer[1[2]--8]:Y query only | Query the specified marker’s resistance value when in Smith 
NR3 chart format. 

:RESist % 

istance —_ 
CALCulate[1!2]:MATH[:EXPRession] EXPRE Select @ trace math expression — choose measurement trace 
<expr>? from (IMPL.) for “date only’ or 
CIMPL/CH<1|2>SMEM) for “tata / memory’. 


1 <expr> and EXPR represent expressions, a patameter tyoe that consists of mathematical expressions that use character parameters and are enclosed in parentheses, 
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CALibration 


SUBSYSTEM COMMANDS 


FORM 


DESCRIPTION 


CALibration: SELF: ALL 


command only 


Initiates 2 SelfCal on all ports that were calibrated during the 
Test Set Cal? 


CALibration:SELF <ON|OFF|ONCE>? NR1 CHAR | Initiates a SelfCal on the currently selected ports and selects 
Periodic SelfCal (ON) or SelfCal Once (OF F or once}! 
| CALibration:SELF: TIMER <num> | NR Sets the time interval for automatic SelfCals. 
| caLibration: ZERO: AUTO <ON| OFF |ONCE>? | NRt Turn on/off the broadband detector autozeraing function. 


1 For use with the HP 87075C multiport test set only. 


2 Binary parameters accept the values of 1 {cni and 6 {off} in addition to ON and OFF. 


CONFigure 
SUBSYSTEM COMMANDS FORM DESCRIPTION 
CONFigure <string> STRING | Configure the analyzer to measure a specific device type and 


parameter ithe (BEGIN) function} — choose from one of 
the following strings: 


?AMPLifier:TRANsmission’ 
*AMPLifier:REFLection’ 
*AMPLifier :POWer’ 
oFILTer: TRANsmission’ 
*FILTer:REFLection’ 
7BBANd: TRANsmission’ 
*BBANd:REFLection’ 
MIXer:CLOSs? 
?MIXer:GDEL’ 

*MiXer :REFLection’ 
*CABLe: TRANsmission’ 
*CABLe: REFLection’ 
*CABLe: FAULT? 

*CABLe: SRL? 
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CONTroi 
SUBSYSTEM COMMANDS FORM | DESCRIPTION 
CONTro1 [4 |2] :MULTiport :STATE <ON{OFF> NRT | when on, configures analyzer for use with ¢ multiport test set? 
1 For use with the HP 87075C multiport test set only. 
DIAGnostic 
SUBSYSTEM COMMANDS FORM DESCRIPTION 
DIAGnostic:CCcOlNstants:INSTalled? | query only | Query if correction constants are installed in flash. Returns a 1 
NRT if true, and a O if false 
i eee 
DIAGnostic: CCOWstants : LOAD command only | load detault factory calibration constants from floppy disk to 
memory. 
DIAGnostic:CCONstants : STORE: DISK command only | Store default factory calibration constants from memory to 
floppy disk. 
DIAGnostic:CCONstants: STORE: EEPRom command only | Store default factory calibration constants from memary to flash 
EEPROM. 
DIAGnostic:COMMunicate:LAN :PING: IMM command only | Option 1f7 only. “Pings” a remote user-specified iP address. 
Used in troubleshooting or verifying a LAN connection. 
DIAGnostic: COMMunicate:LAN:PING:IPAD string Option 1F? only. Sets the IP address to ping. 
<string> 
DIAGnostic: COMMunicate:LAN:SEND NRt Instructs the analyzer to open a socket to the specified IP 
<IP_address> ,<port_num>,<string> STRING address and port number, and and send the string specified. 
Must have Option 1F7 (LAN} and Option 1€2 {iBASIC). 
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DiAGnostic (continued) 


SUBSYSTEM COMMANDS 


FORM a 


DESCRIPTION 


DIAGnostic:MDISplay [1|2]:CORRection 
<string> 


command only 


zm 


Displays corrected measurement uncertainties. Choose from one 
of the following strings: 


Cal check 
*C_DIRECTivity’ 
*C_LDMATCE’ 

*C_ ISOLATION? 
?C_RTRACKING’ 
7C_SRCMATCH? 
>C_TTRACKING’ 


Interpolated Array faccessed through the service menu} 
?T_DIRECTivity’ 

7 RESPONSE? 

7 T_SRCMATCH’ 

7 I_TRACKING? 


Mester Array accessed through the service menu. 
*H_DIRECTivity’ 

»N_RESPONSE?’ 

?M_SRCMATCH? 

*M_TRACKING? 

74 _XSCALAR? 


DIAGnostic:NDISplay [112] :RESTore 


command only 
eee 


Returns to measurement mode and autoscales after viewing 
calibration uncertainties. 


DIAGnostic: PORT: READ? 


query only 
NR1, NRI 


Reads the rear panel 1/0 ports. 


|<port><register>! 


DIAGnostic:PORT: WRITE 
<port><register>! 


— 


NR1, NR1, NR1 


Writes to the rear pane! 1/0 ports. 


DIAGnostic:SNUMber <string>? query only | Query the insvument’s serial number. 
STRING 
ah mi 
DIAGnostic:SPUR: METHod NRI Select the spur avaid mode, 
<NONE | DITHer | AVOid> _| 


1 Refer to “Controlling Peripherals” in Chapter 7 of the User’s Guide for more information on usiag this command, Also see tables 12-1 and 12-2. 
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Table 12-1. Writeable Ports 


— 


Port Number Register Description 
a1 0 Outputs S-bit data to the CentD0 through D7 fines of the Centronics port. Cant_00 is the 
least significant bit, Cent_D7 is the most significant bit. Checks Centronics status linas for: 
Out of Paper 
Printer Not on Line 
BUSY 
ACKNOWLEDGE 

6 1 Sets/clears the user bit accerding to the least significant bit of A. A least significant bit equal 
to { sets the user bit high. A feast significant bit of 0 clears the user bit. 

16 2 Sets/clears the fimit pass/fail bit according to the least significant bit of A. A least significant 
bit equal to 1 sets the pass/fail bit high. A least significant bit of O clears the pass/fail bit, 

— 

18 3 Outputs 8-bit data to the Cent_00 through 07 fines of the Centronics port. Cent_0O is the 
least significant bit, Cent_O7 is the most significant bit. Does not check Centronics status 
lines. 

| 
g 0 Outputs @ byte to the serial port. The byte is output serially according to the configuration 


for the serial port. 


NOTE 


When using the WRITEIOC15,0) or WRITEIO(15,3) command, the Printer_Select Line is 
set High. However, when the instrument is doing hardeopy, the Printer_Select Line is set low The 
Printer_Select line may or may not be used by individual printers. Check with your printer manual 


12-13 


SCP] Command Summary 


Table 12.2. Readable Ports 


L Port Number Register Description 
= 
9 i) Reads the serial port. 

15 0 Reads the 8-bit date port Cent..D0 through D7. 

6 1 Reads the user bit. 

5 2 Reads the limit test pass/fail bit. 

5 att Reads the 8-bit status port. 
DO—Cent_acknowledge 
Di—Cent_busy 
02—Cent_out_of..paper 
03—Cent..on.line 
04—Cent_printer_err 
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BISPlay 
SUBSYSTEM COMMANDS FORM DESCRIPTION 
DISPlay : ANNotation:CHANnel [1|2] NRI Enables/disables measurement channel annotation. 
{:STATe] <OFF|ON>? 
4. 
DISPlay : ANNotation:CHAlnel [1/2] :USER STRING Specifies the string 10 be displayed in the measurement channel 
:LABel : DATA <string>? annotation area (above the graticule}. 
DISPlay : ANNotation:CHANnel [1/2] :USER NRI Enables user-defined measurement chennel annotation. 
:STATe <OFF|/oN>!? 
DISPlay: ANNotation:CLOCk: DATE CHAR Selects the Year/Month/Day ordering of the date in the clock 
:FORMat <char> display — choose from YMD | MDY | DMY. 
DISPlay : ANNotation:CLOCk: DATE: MODE CHAR Selects the format for the date in the clock display — choose 
<char> NUMeric or ALPHa. 
DISPlay: ANNotation:CLOCK:MODE <char> CHAR Selects how the clock will appear in the measurement display 
title area —- choose from LINE1 | LINE2 (OFF. 
DISPLay : ANNotation: CLOCk:SEConds NR1 Turns on/off display of seconds in the clock display. 
[:STATe] <oNlOFF>1 
a eae oes 
DISPlay : ANNotation:FREQuency [1] 2] : CHAR Sets the frequency ennotation on the display — choose 
:MODE <char> | SSTOP {start/stop}, CSPAW [center/spanl or CW. 
DISPLay : AlNotation:FREQuency [112] CHAR Sets the resolution of display frequency values — choose from 
:RESolution <char> | _| waz xz i 2. 
DISPlay : ANNotation:FREQuency [1/2] NRA Enabies/disebles frequency annotation. 
{:STATe] <OFF|oN>? 
i 
DISPlay : ANNotation:FREQuency [1/2] STRING A user-defined X-axis label. 
:USER:LABel:DATA <string> 
DISPlay : ANNotation:FREQuency[1]2] NR3 Specifies the start value for user-defined frequency annotation. 
:USER:STARt <num>* 
DISPLay : ANNotation:FREQuency [1 | 2] NR1 Enables user-defined frequency annotation. 
:USER:STATe [OFF|on]+:? a 
DISPlay : ANNotation:FREQuency[1/]2] NRG Specifies the stop value for user-defined frequency annotation. 
:USER:STOP <num>? 


1 Binary parameters accept the values of 1 {on} and O {off} in addition to ON end OFF. 


2 Refer to “Displaying measurement Results” in Chapter 7 of the User's Guide for more information on using this command. 
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DISPlay (continued) 
SUBSYSTEM COMMANDS FORM DESCRIPTION 
DISPlay : ANNotation:FREQuency[1/2] STRING Specifies the suffix for user defined frequency annotation. 
:USER:SUFFix[:DATA] <string>! 
DISPlay: AWNotation:LIMit:ICON[1/2] NF Enables/cisables the display of the limit test fail icon. 
:FLAGL:STATe] <ON|OFF>? 
iz + 
DISPlay : ANNotation:LIMit: Icon [112] NR Positions the limit test pass/fail text and icon on the display. 
:POSition:X <num> Accepts whole number values from 0 flush left} te 100 {flush 
right}. 
fas 
DISPlay : ANNotation:LIMit:ICON[1 2] NR Positions the limit test pass/fail text and icon on the display. 
:POSition:Y <num> Accepts whole number values from Q bottom of display] to 
108 (top of display). 
DISPlay:ANNotation:LIMit:1CON[il2] NR Tums the limit test “PASS/FAIL” text on or cif. 
:TEXT[:STATe] <oW|OFF>? 
— 
DISPlay:ANNotation:MARKer [i |2] :NUMBers NaI Enables/disables the display of marker numbers on trace 
[:STaTe] <OFF|on>? markers. 
DISPlay : ANNotation:MARKer [1/2] NRt Enablas/disables the active marker annotation for measurement 
[:STaTe] <GN|OFF>? channels 4 and 2 
DISPlay : ANNotation:MESSage: AOFF command only | Turns off any currently showing message window — incuides 
message window, active entry and IBASIC window. 
DISPlay : ANNotation :MESSage: CLEar® command only | Removes a user-defined pop-up message window. | 
DISPlay :AUNotation:MESSage:DATA STRING Displays @ user-defined message in the pop-up message window, 
<string>? Optional argument specifies the timeaut: choose trom 
NONE |SHORt|MEDium| LONG. 
pear —— — 
DISPlay : ANNotation:MESSage:STATe NRi Enables/disables the message window - CAUTION: this 
<ON | OFF>? suppresses display of all messages leven ERROR messagesl. 
i 
DISPLay : AWNotation:TITLe [1/2] :DATA STRING Enters a string for the specified title line 
3 3 
<string> 
— ae! 
DISPlay : ANotation: TITLe[:STaTe] NRI Turns on/off display of the title and clock. 


<ON | OFF>? 


1 Refer to “Displaying Measurement Results” in Chapter 7 of the User's Guide tor more information on using this command, 
2 Binary parameters accept the values of 1 (on) end © fof} in addition to ON end OFF. 
3 Refer to “Operator Interaction” in Chapter 7 of the User’s Guide for more information on using this command. 
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DISPlay (continued) 
SUBSYSTEM COMMANDS FORM DESCRIPTION 
DISPlay: ANNotation:YAXis:MODE <char> CHAR Sets mode for the Y-axis labels — choose RELative or 
ABSolute 
DISPlay : ANNotation: YAXis[:STATe] NRt Turns on/off Y-axis labels. 
<Ou|OFF>? 
DISPlay:CMAP:COLor[112] ... 16] NR2 Changes the default intensity of the selected item on the 
:GREYscale <num> analyzer's internal moniter. 
DISPlay:CMAP:COLor[ii2| ... 16]7:HSL NR2 for use with an external VGA compatible monitor. Sets hue, 
<num> ,<num> ,<num> saturation, and luminance for the selected display item. 
Accepted values for each parameter are 0 to I. 
— 
DISPlay:CMAP:COLor[1|2[ ... 16]: RGB NR2 for use with an external monitor. Sets the color map based on 


<num, num ,num> 


the Red/Green/Blue model. Accepted values for each parameter 
are 0 to 1. 


DISPlay: CMAP: DEFault 


command only 


For use with an external monitor. Sets the color scheme to the 
factory default. 


DISPlay:CMAP:SCHeme <char> CHAR Sets the color scheme for an external monitor. Choose from 
DEFault |DEFault2|GREY|INVerse|CUSTom. 
bam { 
DISPlay:FORMat <char> CHAR Selects the format (full or split screen} for displaying trace data 
| — choose SINGLe (overlay] or ULOWer (split). 
DISPlay:FORMat: EXPAND <ON|OFF> NRI Enatlesidisables expand measurement mode. 
DISPlay : MENU: KEY[112]--7] <string>? STRING Specifies the softkey menu labels from a remote controller or 
IBASIC 
| DISPlay: MEWU[2] :KEY[1/21---7] <string>? STRING Specifies the softkey menu labels when using user-defined 
BEGIN key. {For option 1€2, IBASIC, only) 
DISPlay : MENU: RECal1: FAST[:STATe] NAI Turns on/off fast recall mode. 
<OW {OFF>* 
DISPlay:PROGram[: NODE] <char> CHAR Selects the portion of the analyzer’s screen to be used as an 


HP instrument BASIC display — choose from 
OFF | FULL | UPPer |LOWer. 


1 Binary parameters accept the values of 1 (onl and © {off] in addition to ON end OFF. 


2 Refer to “Operator Interaction” in Chapter 7 of the User‘s Guide tor more information on using this command. 
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DISPiay (continued) 
SUBSYSTEM COMMANDS FORM DESCRIPTION 
—— 
DISPlay :WINDow[1|2| 10] :GEOMetry query only | Query the absolute pixel coordinates of the lower left corner of 


[:sTate] <owlorr>? 


:LLEFT? NR1,NRI the selected display window. 
DISPlay :WINDow[1]21 10]: GEOMetry query only | Query the width and height (in pixels} of the selected display 
:SIZE? | NRLNRT | window. 
| 
DISPlay :WINDow[1|2| 10]: GEOMetry query only | Query the absolute pixel coordinates of the upper right corner 
— NR1NRI of the selected display window. 
DISPlay :WINDow:GRAPhics :BUFFer NRI Turn on/off buffering of user graphics commands. 


DISPlay :WINDow[1|2/10] :GRAPhics” 


:CIRCle <num> 


commend only 


Draw a circle of the specified Y-axis radius centered at the 
current pen location — mum is the radius in pixels? 


DISPLay :WINDow[1/2/10]:GRAPhics? 


— 


command only 


Clear the user graphics and graphics buiter for the specified 


:CLEar window. 
DISPlay :WINDow[1/2/ 10] :GR&Phics? NRI Set the color of the user graphics pen ~ choose from O for 
:COLor <num> erase, 1 for bright, and 2 for dim. 
DISPlay :WINDow[1/2/ 10] :GRAPhics? command only | Craw a line from the current pen position te the specified new! 
[C:DRAW] <numi>,<num2> pen position — num and mum2 are the new absolute X 
and Y coordinates in pixels > 
DISPlay : WINDow[1/2] 10] :GRAPhics” command only | Draw a label with the lower left corner at the current pen 
:LABel <string> location. 
DISPLay : WINDow[1/2] 10] :GRAPhics? CHAR Select the user graphics label font — choase from 
:LABel: FONT <char> SHAL1 | HSMal1| WORMa1 | 
HNORmal | BOLD | HBOLA | SLANt | ESLant. 
DISPLlay : WINDow[1/2/ 10] :GRAPhics? NR1NRi Move the pen to the specified new pen position — num’ ani 


nium are the new absolute X and Y coordinates in pixels? 


:MOVE <numi>,<num2> 


DISPlay : WINDow[1/2] 10] :GRAPhics? 
:RECTangle <numi>,<num2> 


command eniy 


Draw a rectangle of the specified size with lower left cornet at 
the current pen position — numd and num2 are the width 
and height in piels.> 


1 Binary parameters accept the values of 1 ton! and O (off) in addition 
2 Refer te Chapter 7, “Using Graphics,” for more infarmation. 


te ON and OFF. 


3 Refer to Chapter 7, and to the example program titled “GRAPHICS” in Chapter 8 for more information. 
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DISPiay (continued) 
SUBSYSTEM COMMANDS FORM DESCRIPTION 
DISPlay : WINDow[1|2|10] : GRAPhics :SCALe NRT Specifies new coordinates for window. 
<xmin> ,<xmax> ,<ynin,<ymax> 
DISPlay: WINDow[112110] :GRAPhics! query only | Query whether a window is enabled for user graphics 
:STATe? NRI commands. 
DISPlay:WINDow[1!2]:TRACe: NRi Tum on/off display graticule. 
F : 2 
GRATicule:GRID[:STATe] <OMN|OFF> 
DISPlay: WINDow[1|2] : TRACe [ila] NRI Turn on/off the display of trace and memory data trem the 
{:STaTe] <on{ oFF>2 specified measurement channel. 
a i —— 


DISPlay:WINDow[112] :TRACe:¥ 
[E:SCaLe] :AUTO ONCE 


command aniy 


Seale the measurement data for a best fit display, 


: TRACK: FREQuency <num>? 


DISPlay:WINDow[1/2]:TRACe:¥ NRS Specify the height (dB or units per division} of each vertical 
E:SCALe] : PDIVision <num>? division of the specified measurement channel. 
DISPlay: WINDow[1|2] :TRACe:Y NR Specify the value for the Y-axis reference position for the 
[:SCALe]:RLEVel <num>? spectied measurement channel. 

DISPlay: WINDow[1[2]:TRACe:Y NRS Specify the Y-axis reference position for the specified 
([:SCaLe] :RPOSition <num> measurement channel. 

DISPiay: WINDow[1{2/10] :TRACe[i121:¥ CHAR Selects the method for reference offset tracking. 

:TRACk <OFF | PEAK] FREQ> 

DISPlay: WINDow[1]2[10] :TRACe[112] :¥ NAS Selects frequency to track with reference tracking. 


1 Refer to Chapter 7, “Using Graphics,” for more information. 


2 Binary parameters accapt the values of 1 fon) and (off) in addition to ON and OFF. 
3 Numeric parameters may include an appropriate suffix: if no suffix is included, the default {HZ for frequency or S tor timed is assumed. 


FORMat 
SUBSYSTEM COMMANDS FORM DESCRIPTION 
FORMat:BORDer <char> CHAR Specify the byte order used for HPIB date transfer — choose 
NORMal or SWAPped (for Pl-compatibie systems). 
FORMat[:DATA] <char>[,<num>] CHARLNR1 | Specify the date format for use during data transfer — choose 


from REAL, 64 {REAL ,32|INTeger,16| ASCii. 
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HeOPy 
SUBSYSTEM COMMANDS FORM DESCRIPTION 
HCOPy: ABORt command only | Aboris any hardcopy currently in progress. 
HCOPy :DEVice[11213]:COLor <ON| oFF>!.2 NPI Selact monochrome OFF or color ON mode for hardcopy 
output. 
HCOPy :DEVice[11213] :LANGuage <char>? CHAR Select the lenguage for hardcopy cutput — choose from 
PCL|HPGL|EPSon | IBM| PCX|PCL5* 
HCOPy:DEVice[1/2]3] :MODE <char>? CHAR Select the graph and/or tablels} to appear on a hardcopy plot 
— choose from 
GMARKer| GRAPh | ISETt ings | MARKer | TABLe. 
HCOPy :DEVice[1]2|3]:PAGE:MARGin: LEFT NR2 Sets the left margin (for printer cutout] in millimeters. 
<num>? 
HCOPy :DEVice [11213] :PAGE:MARGin: TOP NR2 Sets the top margin (for printer outaut] in millimeters. 
<num>? 
HCOPy :DEVice[112!3] :PAGE:ORIentation CHAR Sets printer output page orientation — choose PORTrait or 
<char>? LANDscape. 
HCOPy:DEVice[1/213] :PAGE:WIDTh <num>* NR2 Sets the print width {for printer output! in millimeters. 
HCOPy :DEVice[1| 213] :PORT <char>? CHAR Select the communications port for hardcopy cutput — choose 
from 
CENTronics | SERial|GPIB|MMEMory | LAW. 
he 
HCOPy :DEVice[1]2] :RESolution <num>* NRI Sets the printer resalution in dots per inch. 
HCOPy (: IMMediate] command only | Initiates a hardcopy output [print or plot). 
HCOPy : ITEM[1} 2/3]: ANNotation:STATe NRI Turns on/off channel and frequency annotation as part of 
<ON|OFF>?)? hardcopy output. 

LE | 
HCOPy : ITEM[1|2|3] :FFEed:STaTe NPI Turns onfoff an automatic form feed at the completion of 
<OF| OFF>!:2 hardcopy output ~ use item 4 for printers and 2 for plotters. 
HCOPy: [TEN [1/213] :GRATicule: STaTe NRI Turns on/off graticule as pert of hardcopy output. 
<OF | OFF>1? 


1 Binary parameters accept the values of 1 fon) end O {off} in addition te GN and OFF. 
2 For DEVice, use 1 for PCL/Epsan printers, 2 fer plotters, and 3 for PCLS printers. 


3 EPSon and IBM produce the same results. 
4 For BEVice, use 1 for PCLV/Epson printers, or 2 fer plotters. 
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HCOPy (continued 

| SUBSYSTEM COMMANDS FORM DESCRIPTION 
co 
HCOPy : ITEM[11213] :MARKer :STATe NRI Turns onfoft marker symbols as part of hardcopy sutaut. 
<ON | OFF>?:? 
rapreoaans | 
HCOPy : ITEM[1[2/3] :TITLe:STAaTe NRI Turns on/off title and clock lines as part of hardcopy output. 
<on |OFF>}? 
ca | 

HCOPy :ITEM[1/2/3] :TRACe:STaTe NRY Turns on/otf trace data as part of hardcopy output. 
<ow |OFF>1:? 


1 Binary parameters accept the values af 1 fon} and O ioff) in addition to ON and OFF. 
2 For DEViee, use 1 for PCL/Epson printers, 2 for plotters, and 3 fer PCLS printers. 


INITiate | 
SUBSYSTEM COMMANDS | FORM | DESCRIPTION 
INITiate(1/21:CONTinuous <ON|OFF>* | NR1 Set the trigger system to continuously sweep or ta stop | 
sweeping. 
INITiate [1/2]: 1MMediate] | commend only | ite a new measurement sweep. 


1 Binary parameters accept the values of 1 (on) and @ {ofil in addition to ON end OFF. 
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MMEMory 
SUBSYSTEM COMMANDS FORM DESCRIPTION 
a 
MMEMory : CATalog?<string>* query only | List the names of the files in memory. 
STRING 
—— 

MMNEMory:CDIRectory <string> STRING Change the current directory on 2 DOS formatted disk — new 

directory must be on the same mass storage device. 
MNEMory: COPY <string1> ,<string2>)? command only | Copy a fle — string’ is the source file, string? is 

the destination file. 

—— ——| 

MMEMory : DELete <string>? * command only | Helete a file ~ stximg is the filename. 
MMEMory : INITialize command only {Format a disk — string is the mass storage device MEM: 
[<string> (,<char>[,<num>]]] internal memory}, or INT: linternal floppy disk. Disk format 

char is DOS, and the interleave factor num. 
MMEMory:LOAD:STATe 1, <string>! 3 command only | Recall an instrument state from mass storage ~ string is 

the filename. 

| 
MMEMory: FILE: INFO?<string>! query only | Returns file information such as date/time 
STRING 

MMEMory :MDIRectory <string>? command only | Make a new directory on a DOS formatted disk. 
MMEMory : MOVE <string1>,<string2>!? command only | Move or rename a file — string1 is the source [or old! 

filename and stxing? is the destination (or new! filename. 
MMEMory:MSIS <string> STRING Select a mass storage device — choose MEM: {internal 


memory), or INT: internal floppy disk drivel. 


MMEMory: RDIRectory <string>* 


command only 


Delete @ directory from @ DOS formatted disk. 


MMEMory:STORe:STATe 1, <string>??:? 


command only 


Save an instrument state to mass storage — stxing is the 
filename. 


MMEMory :STORe : STATe: CORRection 
<on| oFF>* 


NRI 


Jurn on/off the calibration —~ part of the definition of a saved 
file. 


1. Fitenames may include the mass storage device — MEM: {internal non-volatile memoryl, RAM: (internal velatile memary), or INT: linternal 3.5” disk drive). Wildcards ? 


and * may be used. 


2 Be sure ts catalog the desired disk using MMEMEMSIS before using this command. 
3 Refer to “Autornated Measurement Setup and Control” in Chapter 7 of the User’s Guide or mare information on using this command. 


4 Binary parameters accept the values of 1 ton) and 0 {off} in addition to OM and OFF. 
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MMEMory (continued) 
SUBSYSTEM COMMANDS FORM DESCRIPTION | 
MMEMory :STORe:STATe: FORMat <char> CHAR Saves instrument state files to be compatible with older "4/3" 


model analyzers {choose B87 141), or with current “C" model 
analyzers {choose C8711). 


MMEMory :STORe:TRACe <char>,<string> 


— ——} 
MMEMory :STORe:STATe:ISTate <OW| OFF>? NRI Jur on/off the instrument state — part of the definition of a 
saved file. 
MMEMory :STORe:STATe: TRACe <ON| oFF>! NRi Turn on/oif the data trace — part of the definition of a saved 
file. 
MMEMory :STORe:STATe:TSCAL <ON| oFF>! NRI When on, saved state will be the test set cal only. 
2,3 


command only 


Stores an ASCII list of trace and frequency values to a file ~ 
char jis the formatted data trace CH<1!2>FDATA and 
string 's the filename. 


| Seles the format that the ASCII date will be saved in. 


MMEMory :STORe:TRACe:FORNat <char> CHAR 

Choose fom LOTus123 or TOUChstone. 
MMEMory : TRANsfer :BDAT STRING, Copy a file to or from the analyzer's disk dive? 
<string>?[,<block>]* BLOCK 
MMEMory : TRANsfer[:HFS] STRING, Copy a file to or from the anatyzer's disk drive. 
<string>? [,<block>]* 


1 Binary parameters accept the values of 1 (on! and 8 {off} in addition to ON and OFF. 
2 Filenames may include the mass storage device — MEM: {internal ponvoletile memory!, RAM: linterna! volatile memory}, or INE: {internal 3.5" disk drive). Wildcards ? 


and “ may be used. 


3 Refer te “Automated Measurement Setup and Control” in Chapter 7 of the User’s Guide for more intormation on using this command. 


4 Refer to Chapter 8, “Example Programs” for mere information on us 
5 Refer to the exemple progiams PUTFILE and GETFILE in Chapter 8. 


ing this command. 


OUTPut 


SUBSYSTEM COMMANDS 


- 


| FORM 


DESCRIPTION 


: jourput {:STaTe] <on | OFF>! 


NR 


| 


Turn on/off RF power irom the source, 


1 Binary parameters accept the values of { lon} and @ ‘offi in addition ts OM and OFF. 
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POWer 
SUBSYSTEM COMMANDS FORM DESCRIPTION 
POWer[1|2]:MODE <char> CHAR | Specify either frequency sweep (FIXed] cr power sweep 


|(SWEepi. 


12-24 


SCPI Command Summary 


[ SUBSYSTEM COMMANDS 


fe Form | 


DESCRIPTION 


PROGram! : CATalog? 


List the names of the defined IBASIC programs — response is 
“PROG” lif a program w present] or the null string {*"). 


PROGram! [:SELected]?:DEFine <block> 


| Download an (BASIC program trom an extemal controller. 


PROGram! [:SELected]?:DELete: ALL 


| equivalent to an HP BASIC SCRATCH A commend. 


Delete all IBASIC programs from the program buffer — 


PROGram! [:SELected]?:DELete 
[:SELected] 


Delete the active IBASIC program — equivalent to an HP BASIC 
SCRATCH A command. 


PROGram! [:SELected]*:EXECute <string> 


Execute an IBASIC command. 


PROGram! [:SELected]*:NALLocate <num> 


Allocate memory space for IBASIC programs — choose from a 
real number between 2048 and 4000000 bytes. 


= 
PROGram'[:SELected]*:NAHE *PROG’ 


Select the IBASIC program in the program buffer to be active. 


PROGram! [:SELected]?: FUMBer 
<string> ,<data>® 


load a new value for a numeric variable string in the 


PROGram! [:SELected]?:STATe <char> 


active IBASIC program — mum is the new value. 
| Ba 


Select the state of the active IBASIC program ~~ cheese from 
STOP | PAUSe | RUN |CONTinue. 


PROGram! [:SELected]?:sTRing 
<stringi>,<string2> 


load a new value for a string variable stringt in the 
active IBASIC program — string? is the new value 


PROGram! [:SELected]?: WAIT 


Wait until the IBASIC program completes. 


1 Commands in the PROGram subsystem are only available when the HP Instrument BASIC BASIC! aption és installed joption 102). They aliow you to generate and 


contra! IBASIC programs is the analyzer. 


2 Commands grouped under the SELected mnemonic in the PROGram subsystem operate on the active program buffer. 
3 The parameter type af the data is determined hy the format selected ~ FOBMat REAL uses BLOCK date, FORMat ASCH uses NRJ data separated by commas. 
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ROUTe/1/21 
SUBSYSTEM COMMANDS FORM DESCRIPTION 
ROUTe [1/2] :REFLection: PATH :DEFine: PORT NRI Selects which port of the test set is connected to the 


<4]2] ... [12> 


REFLECTION port of the analyzer. 


ROUTe[1|2] : TRANsmission: PATH: DEFine: NRI Selects which port of the test set is connected to the 
PORT <il2/ ... [12> TRANSMISSION port of the analyzer? 


1 For use with the HP 870750 multipart test set only. 
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:CONNector <num> 


SENSel1/2] 
SUBSYSTEM COMMANDS FORM DESCRIPTION 
SEWSe [1/2]: AVERage:CLEar command only | Restart the tace avereging function. 
SEWSe[1[|2]:AVERage:COUNt <num> NR1 Specify a count or weighting factor for the averaged 
measurement data. 
| sense [1[2] :AVERage[:STATe] <CN|OFF>? NR Tum on/off the ace averaging function. 
SEWSe[1{2]:BWIDth[:RESolution] <num> NR2 Specify the bendwidth of the IF receiver (fine, narrow, medium 
HZ or wide] to be used in the measurement ~ choose 15 {fine} 
250 narrow! 1200 [medium narrow) 3700 {medium} 
4000 (medium wide] or 6500 {wide}. 
SEWSe[1]2]1:CORRection:ANNotation? query only {Returns the current calbration annotation: either "C", 
BOP, gr MH, 
SEWSe [1/2]: CORRection:CAPacitance NR3 Select connector compensating capacitance value. [For use with 


structural return loss measurements on analyzers with Option 
700 only.) 


SEWSe [1/2]: CORRection:COLLect : ABORt 


command only | Abarts ‘the calibration that is currently in progress. 


SENSe [112] 
{:aCQuire] 


:CORRection:COLLect 
<char> 


command only 


Measure a calibration standard — select from: 


STANdard1—Open 
STANdard2-Short 
STANdard3~load 
STANdard4—Through cable 


SENSe [112] :CORRection:COLLect 
:CKIT[:SELect] 


STRING 


Select Cal Kit 

Choose from one of the following strings: 
“COAX, 7MIM, TYPE-N50, FEMALE” 
“COAX,7MM, TYPE-N,SO,MALE’ 
*COAX,3.5,APC-3.9,50, IMPLIED" 

"USER, IMPLIED IMPLIEDIMPLIED, IMPLIED’ 
"COAX, 7MM,TYPE-£75, IMPLIED’ 

“COAX, 7MIM,TYPE-N,75, FEMALE’ 

“COAX, 7MM,TYPE-N,7, MALE” 


SENSe [1/2]: CORRection:COLLect 
:ISTate[:AUTO] <ON|GFF>* 


NRi 


Select the instrument state for calipration — choose Full Band 
{OM or User Defined (OFF). 


1 Binary parameters eccept the values of 1 ten] and G (off in addition to ON and OFF. 
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SENSel1(2] (continued) 


SUBSYSTEM COMMANDS 


FORM 


DESCRIPTION 


SENSe[i|2]:CORRection:COLLect 
iMETHod <char> 


command only 


Select the type of calibration — choose from: 


TRAN 1—Trensmission response 
TRAN2—lransmission response & lsolation 
TRAN3—Tansmission enhanced response 
REFL3—Retlection one port 

TEST—Tst Set Calibration? 
VERIFY—Calibration Check 


SENSe[1[2]:CORRection:COLLect :NP: OPEN command only | Measures an open on the port selected during @ test set 
<STANL|STAN2{ ... |STAN12> calibration? 
SENSe[1}2]:CORRection:COLLect:MP:SHORT | command only | Measures @ short on the port selected during @ test set 
<STAH1/STAN21 ... |STAW12> calibration? 
SENSe[1/2]:CORRection:COLLect :MP: LOAD command only | Measures 2 load on the port selected during @ test set 
<STAN4 |STAN | {STAN12> calibration 1 
SENSe[1|/2]:cORRection:COLLect :HP: THRU command only | Measures 2 thru on the port selected during a test set 
<STAH1/STAW2| ... [STANE> calibration. 
SENSe{i|2]:CORRection:COLLect: PORTS NRi Selects the number of ports to perform a test set calibration 
<214/616/ 10] 12> ont 
SENSe[1|2]:CORRection:COLLect :SAVE command oniy | Complete end save current calibration. 

| SENSe [1/2] :cORRection:COLLect : VERify command only | Measures a calibration standard during a cal check procedure 


:REFLection <STAN1|STAN2| ... [STAN12> 


for reflection measurements, 


SENSe[1|2]:CORRection:COLLect : VERify 
:TRANsmission <STANi|STAN2[ ... 
[ISTAH12>; 


command only 


Measures @ calibration standard during a cal check procedure 
for transmission measurements. 


SENSe [1/2] :CORRection: CSET 
i (:SELect] DEFault 


command only 


Restore the “lactory’ default calibration for the current 
measurement and channel. 


SEEN 
SEWSe[1|2]:CORRection:CSET query only | Query the current calibration type — returns DEF {factory 
[:SELect]? CHAR default], FULL {full band) or USER [user defined}. | 
Q@BSEWSe [1 [2] :CORRection: EDELay: TIME NRS Specifies the electrical delay in seconds. 


<num>? 


1 For use with the HP 87075C multipart test set only 


2 Numeric parameters may include an appropriate sutfoc if no suffix is included, the default HZ for frequency ar $ for time} is assumed. 
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SCPi Command Summary 


SENSel1 |2] (continued) 


SUBSYSTEM COMMANDS FORM DESCRIPTION 
@SENSe [1] 2] :CoORRection:EXTension NR3 Specifies the port extension at the reflection port, in seconds. 
:REFLection[: TIME] <num>? 
@SENSe[1|2] :CORRection: EXTension ARI Enables port extensions. 
[:STATe] <OW|OFF>? 
SBSENSe [1] 2] :CORRection:EXTension NR Ssecifies the port extension at the transmission port, in seconds, 
:TRANsmission[{: TIME] <nun>! 
QSSENSe [1] 2] :CORRection: IMPedance: NR3 Specifies the reference impedance for the Smith chart display. 
The default is the analyzer’s system impedance. 
INPut :MAGNitude<num>! 
SENSe[1|2]:CORRection: IMPedance: NR Selects 50 chms as the system impedance. 
INPut :MAGNitude:SELect ZO_50 
SENSe [1/2] :CORRection: IMPedance: NARI Selects 75 ohms as the system impedance. 
INPut :MAGNitude:SELect ZO_75 
SENSe[i|2] :CORRection: LENGth: COAX NR2 Specifies the length of casle tc be calibrated, in feet or meters. 
<num> (For use with fault location measurements on analyzers with 
Option 100 only! 
SENSe [1/2] :CORRection: LENGth NR2 Specifies the length of an interface connector, in mm or inches. 
:CONWNector <num> {For use with structural return loss measurements on analyzers 
| with Option 100 only) 
SENSe [1/2] :CORRection:LOSS:CQAX <num> NR2 Specifies the loss of a cable under test, in dB/100 ft. {For use 


with fault location measurements on analyzers with Option 100 
only 


SEWSe [1|2] :CORRection: MODel :CONNector 
[:IuMediate] 


ee | 


command only 


Measure the cable connector and determine the optimum values 
for connector length and connector capacitance. [For use with 
structural return loss measurements on enalyzers with Option 
100 only) 


1 Numeric parameters may include an appropriate suffix; if no suffix is included, the default (NZ for frequency ar $ for time) is assumed. 
2 Binary parameters accept the values of 7 ten} and @ tofl} in addition ta OM and GFF. 


& indicates HP 8712B/148 only 


SCP] Command Summary 


SENSe|1|2] (continued) 


SUBSYSTEM COMMANDS FORM DESCRIPTION 

QBSEWSe [112] : CORRection:OFFSet :PHASe NR3 Specifies the phase offset, 

SENSe[1[2] :CORRection: PEAK: COAX NARI Turns multipeak correction on or off. (For use with fault 

[:STaTe] <ON|OFF>! location measurements on analyzers with Option 100 only.) 

GBSENSe[112] : CORRection:RVELocity: COAX NRG Specifies the velocity factor to be used when displaying the 
distance for electrical length and port extensions. 1.0 = the 
speed of light. 

<num>? ; 

SENSe[1i| 2] :CORRection:RVELocity command only | Measure the cable and determine the optimum values for cable 

C: IMMediate] joss and velocity factor. (For use with fault location 
measurements on analyzers with Option 100 oniy) 

SENSe[1]2] :CORRection:TESTSET command only | Brings up the Test Set Cal menu? 

SENSe[i|2]:CORRection: THReshold NR2 Selects multi-peak threshold value, in d3. (For use with fault 

:COAX <num> location measurements on analyzers with Option 100 only} 

SENSe[1[2]:COUPle <char> CHAR Turn on/off the alternate sweep mode — choose ALL [coupled 
sweep] or NOE lalternate sweepi. 

SENSe[1|2] :DETector[:FUNCtion] <char> CHAR Specify which detection mode is used to make the measurement] 
~ choose BBANd {broadband} or NBANd {narrowband}. 

SENSe[1|2] :DISTance:CENTer <num> NRS Set the center distance for a fault location measurement, in 
feet or meters. {for use with fault location measurements on 
analyzers with Option 100 only.) 


1 Binary parameters accept the values of 1 {an} and @ loffl in addition to ON and OFF. 
2 Numetic parameters may include an appropriate suffix; no suffix is included the default (HZ for frequency or $ for time) is assumed. 


3 For use with the HP 87075C multiport test set only 
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SENSel1|2] (continued) 


~ 
SUBSYSTEM COMMANDS FORM DESCRIPTION 

SEWSe[1{2]:DISTance:STARt <num> NR3 Set the start distance for a fault location measurement, in feet 
of meters. [For use with fault location measurements on 
analyzers with Option 100 only.) 

SENSe{1]2]:DISTance:STOP <num NR3 Set the stop distance for 2 fault location measurement, in feet 
or meters. {For use with fault iccation measurements on 
analyzers with Option 100 only) 

SENSe[i|2]:DISTance:UNITs <char> CHAR Specifies distance units. Choose METers or FEET. {For use 
with fault location measurements on analyzers with Option 100 
only} 

SENSe [i[]2] : FREQuency: CENTer <num>? NR3 Set the center frequency of the RF source. 

SENSe[{1/2]:FREQuency: MODE <char> CHAR Set the fault location measurement to CENT ex (bandpass) or 
LOWPass.|For use with fault location measurements cn 
analyzers with Option 100 only 

SENSe [112] :FREQuency: SPAN <num>t NR Set the frequency span of the RF source. 

SENSe [1]2] :FREQuency: SPAN NR3 Set the maximum frequency span of the RF source for 

:MAXimum <num>! bandpass fault location measurements. (For use with fault 
location measurements on analyzers with Option 100 oniy.) 

— 
SEWSe [1 [2] :FREQuency: STARt <num>! NR Set the start frequency of the RF source. 
— 

SEWSe[1[2]:FREQuency: STOP <num>! NR Set the stop frequency of the RF source. 

SENSe [112] :FREQuency: ZSTOp <nun>! NR Set the Z cuteff frequency for cable impedance calculations. 
{For use with structural return loss measurements on analyzers 
with Option 100 only] 

SENSe [112] :FUNCtion? query only | Query the measurement function ~ returns one of the 

STRING *XFR:POW . . .? of ?XFR:POW:RAT ... ” 
strings described below. 

SEWSe[112]:FUNCtion *XFRequency command only | Specify that the receiver will measure the power inte @ specific 

:POWer <num>? detecter on the specified measurement chennel — choose from 
detectors © (Ri, 1 tA), 2 (Bl, 14 {Ext X) or £2 {Ext Y}. 


1 Numeric parameters may include an appropriate suffic if no suffix is included, the default (HZ for frequency oF S for time) is assumed. 
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SENSel1{2) (continued) 


SUBSYSTEM COMMANDS FORM DESCRIPTION 
SENSe{1|2]:FUNCtion ’XFRequency command only | Specify that the receiver will measure a ratio of the power inte 
:POWer:RATio <num>,<num>’ the specified measurement channel — choose from ratios 1,0 

(ARI, 2,0 (B/R, 12,0 (Ext Y/R], 14,12 (Ext Xe Y], or 
12,44 (Ext V/bxt Xi). 
SENSe [112] :FUNCtion:FAULt: CONNector command only | Forces a connector verification measurement on the alternate 
{: IMMediate] channel. (For use with fault location measurement on analyzers 
with Option 100 only) 
| SENSe (112] :FUNCtion:SRL: IMPedance | NR2 Set the cable impedance. [For use with structural return loss 
| <num> measurements on analyzers with Option 100 only.i 
“Tr 
SEWSe [112] :FUNCtion:SRL:MQDE <char> CHAR Set the auto z function to AUTO or MANual. (For use with 
structural return ios measurements on analyzers with Option 
400 only.) 
SENSe [1 |2] :FUNCtion:SRL: SCAN command only | Start a cable scan. [For use with structural return less 
{:IMMediate] measurements on analyzers with Option 100 only, 
~ am 
SENSe [i112] :ROSCillator:SOURce <char> CHAI Specify the source of the reference oscillator — select 
INTernal or EXTernal. 
— 
SENSe [i112] :STATe <O¥] oFr>! NRi Turn on/off the specified channel. 
he 
SENSe{1|2] :SWEep:POINts <num> NR Set the number of data points for the mesurement — choase 
from 315111121154 110112011404 801 | 1601. 
SEWSe[1|2]:SWEep: TIME <num>? | __NRS__| Set the sweep time 
SENSe[1/|2] :SWEep: TINE: AUTO NR Tum on/off the automatic sweep time function. 
i 
<ON {OFF | ONCE> | i 
SEWSe:SWEep:TRIGger :SOURce <char> CHAI Set the trigger source for each point in a sweep ~ choose 
IMMediate or EXTexnal {used in conjunction with 
TRiGger [ :SEQuence] : SOURcel. | 
SEWSe:WINDow[: TYPE] <char> CHAR Set the window selection for fauh location measurements. 
Choose from RECTangular (Minimum|, RAMMing 
\Medium!, or KBESsel |Maximum}. (For use with fault 
location measurements on analyzers with Option 102 only) 


1 Binary parameters accept the values of 1 (on! and C {offi in addition to ON and OFF. 


2 Numeric parameters may include an approoriate suffix; if no suffix is included, the default {HZ for frequency or S for timel is assumed. 
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SOURce 
SUBSYSTEM COMMANDS FORM DESCRIPTION 
souRce[1 12] :PoWer[:LEVel] NR3 Set the RF power output fram the source. 
[:IMMediate] [:AMPLitude] <num>! 
SOURce [112] :POWer:PRESet <num> NR3 Sets the power level that the analyzer will always return to 
after an instrument preset. 
sQURce [112] :POWer:RANGe <char> CHAR Specifies the power sweep range. Choose from ATTend 
| ATTen10 [ ATTen20 | ATTen30 | ATTen40 
|aTTen5S0| ATTen60. 
SOURce[1|2]:P0Wer:STARt <num> NR3 Sets the power sweep start power. 
+ 
SOURce[1|2]:POWer: STOP <num> NR3 Sets the power sweep stop power. 


1 Numeric parameters may include an appropriate suffix, if ne suffix is included, the defeult (HZ for frequency or S for time] is assumed, 
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STATus 
i SUBSYSTEM COMMANDS FORM DESCRIPTION 
af 
STATus: DEVice:CONDition? query only | Read and clear the Device Status condition register”. 
NRt 
| STATus: DEVice:ENABle <num> NRI Set and query bits in the Device Status enable register” 
STATus:DEVice[:EVENt]? query only | Read and clear the Device Status event register! 
NAI 
STATus:DEVice:NTRansition <num> NRI Set and query bits in the Device Status negative transition 
register.” 
STATus:DEVice:PTRansition <num> NRT Set and query bits in the Device Status positive transition 
register. 
at _-| 
STATus : OPERation: AVERaging query only | Read the Averaging status condition register. 
:CONDition? NRI 
STATus : OPERation: AVERaging : ENABle NRI Set and query bits in the Averaging status enable register.” i 
<num> } 
STATus: OPERation: AVERaging[: EVENt]? query only | Read and clear the Averaging status event register! 
NRI ie 
STATus: OPERation: AVERaging NRI Set and query bits in the Averaging status negative transition 
:NTRansition <num> register.” 
' 
STATus: OPERation: AVERaging NRT Set and query bits in the Averaging status positive transition 
:PTRansition <num> register” 
—e 
STATus :OPERation: CONDition? query only | Read the Operational Status condition register? 
NRI ak 
STATus:OPERation: ENABle <num> NR Set end query bits in the Operational Status enable recister.2 
STATus : OPERation[:EVENt]? query only | Read and clear the Operational Status event register* 
NRi 


4 Returns the sum of the decimal weights (2° where nis the bit number) of all bits currently set. For more information on using the status registers refer to Chapter 5, 
“Using Status Registers.” 


2 num is the sum of the decimal weights of all bits to be set. 
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STATus (continued) 
SUBSYSTEM COMMANDS FORM DESCRIPTION 
STATus: OPERation: MEASuring query only | Read the Measuring status concition register. 
;CONDition? NRT 
STATus : OPERation: NEASuring : EWABle NAA Set and query bits in the Measuring status enable register” 
<num> 
cm Tr 
STATus : OPERat ion: MEASuring [:EVENt]? query only | Read and clear the Measuring status event register? 
NRT 
STATus : OPERat ion: MEASuring NRI Set and query bits in the Measuring status negative transition 
:WTRansition <num> register? 
STATus : OPERat ion: MEASuring NRT Set and query bits in the Measuring status pesitive transition 
:PTRansition <num> register. 
STATus:OPERation:'TRansition <num> NRI Set and query bits in the Operational Status negative transition 
register” 
—| 
STATus:OPERation:PTRansition <num> NRI Set and query bits in the Operational Status positive transition 


register, 


STATus : PRESet command only | Set bits in most enable end transition registers to their default 
i | State, 

STATus : QUEStionable: CONDition? query only | Read and clear the Questionable Status condition register? i 
NRI 

STATus : QUEStionable:ENABle <num> NRI Set and query bits in the Questionable Status enable ragister? 

+~ 

STATus : QUEStionable[ :EVENt]? query only | Read and clear the Questionable Status event register. 
NR1 

STATus : QUEStionable:LIMit query only | Read and clear the Limit Fail condition register? 

:CONDition? NB1 

STATus :QUEStionable:LIMit:ENABlLe <num> NRI Set and query bits in the Limit Fail enable register” 


1 Returns the sum of the decimal weights (28 where n is the bit number) of all bits currently set. For mare information on using the status registers refer to Chapter §, 


“Using Status Registers.” 
2 mum is the sum of the decimal weights of all bits ta be set. 
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STATus (continued) 
SUBSYSTEM COMMANDS FORM DESCRIPTION 
STATus: QUESt ionable:LIMit [: EVEN]? query only | Read and clear the Limit Fail event register.2 
NRI 
STaTus: QUEStionable:LIMit NRI Set and query bits in the Limit fail negative transition register? 
iNTRansition <num> 
STATus: QUEStionable:LIMit NRT Set and query bits in the Limit Fail positive transition register.” 
:PTRansition <num> 
STATus:QUEStionable:NTRansition <num> NRI Set and query bits in the Questionable Stetus negative 
transition register” 
STATus: QUEStionable:PTRansition <num> NRI Set and query bits in the Questionable Status positive transition 


register.2 


1 Returns the sum of the decimal weights (2" where n is the bit number} of all bits currently set. Far more information on using the status registers refer te Chapter 5, 


“Using Status Registers.” 
2 mum is the sum of the decimal weights of all bits to be set. 
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SYSTem 
SUBSYSTEM COMMANDS FORM DESCRIPTION 
SY¥STem: BEEPer [: IMMediate] NR3, NR3, NR3] Instructs the analyzer to beep. Arguments are frequency (Hz, 
[<freq>L,<dur>f,<vol>]]]? duration (seconds), and volume {0 to 11. i 
roe : 
SYSTem:BEEPer:VOLume <num> NR2 Set the volume of the beeper — num is a number between | 
© for 0% and 1 for 100%. : 
SYSTem: COMMunicate:GPIB:COlTroller NRI Makes the analyzer the system controller. 
[:STATe] <oN|OFF>?° 
SYSTem:COMMunicate :GPIB:ECHO <ON|OFF>? NRI Turn on/off HP-IB mnemonic echo. 
SYSTem: COMMunicate:GPIB:HCaPy NAY Set the address of an HP-IB printer or plotter for hardcopy 
:ADDRess <num> output - num must be an integer between 0 and 30. : 
SYSTem:COMMunicate:GPIB[:SELF] NRI Set the analyzers HP-IB address ~ mum must be an integer ‘ 
:ADDRess <num>* between 0 and 30. i 
-— i 
SYSTem: COMNunicate:LAN:EADDress? query only | Queries the analyzer’s ethernet address. \ 
SYSTem:COMMunicate :LAN:IPADdress STRING Sets the analyzer's Internet Protocol address. | 
<string> : 
1 cee 
SYSTem:COMHunicate:LAN:PRINter:HOSTname| STRING Specifies the IP address of the LAN printer. 
<string> _| aie 
SYSTem:COMMunicate:LAN:ROUTe:GATeway STRING Sets the IP address for ¢ LAN gateway. 
<string> 
= 4 
SYSTem: COMMunicate : LAN: ROUTe:SMASK STRING Sets the subnet mask. 
<string> 
SYSTem:COMMunicate:LAN:STATe <ON | OFF>? STRING Turns networking on or off. 
SYSTem:COMMunicate:SERial:TRANsmit NRI Set the haud rate for hardcopy output to a device on the serial 
?BAUD <num> port — choose from 
1200 | 2400] 480019600 | 19200. 
SYSTem:COMMunicate:SERial :TRANsmit CHAR Set the handshake for communication to @ hardeopy device on 
:HAWDshake <char> the serial port — choose XON or DTR. 


1 <freq>, <dur>, and <vol> are optional <num> parameters. 

2 Binary parameters accept the values of 1 fon} and @ {off} in addition to ON and OFF. 
3 For use with IBASIC — this command cannot be executed from an external contrelier. 
4 A delay of & seconds is required before a command is sent to the new address. 
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SY¥STem (continued) 
SUBSYSTEM COMMANDS FORM DESCRIPTION 
SYSTem: COMMunicate: TTL: USER: FEED CHAR Selects the function of the USER TTL IN/OUT port on the rear 


<char> 


panel of the analyzer. Choose from 
DEFault [KEY |SwWEep. 


SYSTem:DATE <numi>,<num2>,<num3> 


NRUNAT, NR1 


Set the year (num4ij, month (mum2| and day imum3} of the 
real time clock 


a 


SYSTem:ERRor?! 


query only | Query the error queue — returns the error number aad 
NRtSTRING | message. 
SYSTem: KEY <char> command only | Sends key names® which execute the same functions as front 
panel keys. 
SYSTem: KEY : MASK? query only | Query the mask (shift, ctrl, alt} associeted with @ keypress on 
NR an extemal keyboard. 


SYSTem: KEY: QUEue:CLEar 


command only 


Clears the key queue. 


i 


SYSTem: KEY : QUEue: COUNT? query only | Query the number of key codes in the queue. 
NRi 

SYSTem: KEY: QUEue:MAXimum? query only | Query the size of the Key queue (the maximum number of key 
NRI codes it can hold). 

SYSTem:KEY:QUEue[:STATe] <ON|OFF>? NFI Turn on/off the key queue. 

SYSTem: KEY: TYPE? query only | Query the type of key that was pressed — returns NONE, 
CHAR RPG, KEY {front panel key] or ASC {external keyboard). 


command only 


Sets the User Request bit of the Standard Event Status Register| 


| SYSTem: KEY: USER 
SYSTem: KEY[: VALuel? 


query only 
NRI 


Query the key code value for the last key pressed ~ RPG 
type returns the knob count, positive for cleckwise retation, 
KEY type rewrns the frent panel keycode? and ASC type 
returns the ASCIl code number. 


1 Fer more information on errors, refer to Chapter 14, “SCPI Error Messages.” 
2 Binary parameters accept the values of 1 {on} and O (offi in addition to GN and OFF. 
3 A list of the analyzer’s front panel kaycodes and key names is provided in Chapter 9. 
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SYSTem (continued) 


SUBSYSTEM COMMANDS 


FORM 


DESCRIPTION 


SYSTem: PRESet 


command only 


Perform a system preset — this is the same as the front panel 


PRESET) key. 


SySTem: SET <block> 


command only 


Send a learn string {obtained using *LRN?) to the enalyzer — 
this command is included in the learn string. 


eee! 
SYSTem:SET:LRN? [<USER>]! BLOCK Query or set the instrument state. 
SYSTem: SET: LRNLong? [<user>]! BLOCK Query of set the instrument state, data, and calbration. Similar 
to savefrecall. 
St cera 
SYSTem: TIME <numi>,<num2>,<num3> NR1,NR1, NRT | Set the hour (mami), minute (rum2} end second Inum3} of 
the real time clock, 
S¥STem: VERSion? query only | Query the SCPI version of the analyzer. See *IDN? to query 
NR2 the firmware revision. 


1 Refer te “Autemated Measurement Setup and Control” ia Chapter 7 of the User’s Guide tor more information on using this cammand. 


TEST 

| SUBSYSTEM COMMANDS FORM DESCRIPTION 

bes 

TEST: RESult? query only | Query the result of the selected adjustment or self-test — the 

CHAR fesponse wil be NULL|PASS|FAIL. 

TEST: SELect <num> NRI Select the adjustment or self-test to execute 

TEST: STATe <char> CHAR Select the state of the active adjustment or self-test ~ choose 
from RUN| CONTinue| STOP for the command. Query 
returns NULL | RUN [PAUS | DONE. 

[Test: vate <num> NRI Set or query a value for an adjustment or selftest. 


SCPI Command Summary 


TRACe 
SUBSYSTEM COMMANDS FORM DESCRIPTION 
TRACe[: DATA]? <char> query only | Query trace data -- choose from 


BLOCK or NRG? 


CH<1/2>FDATA formatted data, 

CH<1|2>FMEM formatied memory, 
CH<11/2>SDATA unformatted cata, 

CH<1}2>SMEM unfermatted memory, 
CH<1{]2><A|B{R>FWD raw data, or 

CH<1 | 2>SCORR<1121314> correction data. Nete: 
See Chapter 6, “Trace Date Transfers,” for data array details. 


TRACe[:DATA] <char>,<data> 


command only 


Input tace data — cheose from the above list of arrays. The 
data can be either BLOCK or NR type? See Chapter 6 for 
more information. 


TRACe[:DATA] <chari>,<char2> 


command only 


Move data from one internal array to another - char is 
the target erray (CH<1|2>SMEM while char2 is the 
source atray {CH<1|2>SDATAI. Note that the source and 
target arrays must be from the same measurement channel. 


1 The parameter type of the data is determined by the iormat selected ~ FORMat REAL uses BLOCK data, FORMat ASCit uses NAB data separated by commas. 


TRIGger 
SUBSYSTEM COMMANDS FORM DESCRIPTION 
CHAR Set the source for the sweep trigger signal ~- choose 


TRIGger [:SEQuence] :SOURce <char> 


IMMediate or EXTernal lused in conjunction with 
SENSe : SWEep: TRIGger : SOURce). 
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SCPI Conformance Information 


The HP 8711C/12C/13C/14C RF Network Analyzers conform to the 
1996.0 version of SCPI. 
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SCPI Standard Commands 


The analyzer implements the following IEEE 488.2 standard commands: 


*CLS 
*ESE 
*ESE? 
+ESR? 
*xIDN? 
+LRN? 
*OPC 
*O0PC? 
*OPT? 
*PCB 
*#PSC i 
*RST 
*SRE 
*SRE? 
*STB? 
*TRG 
*TST? 
*WAT 


The analyzer implements the following SCPI 1996.0 standard commands: 
ABORt 


CALCulate[1 [2] :DATA? 
CALCulate[1]2] : FORMat 
CALCulate[1[2] : FORMat? 
SSCALCulate [1/2] :GDAPerture: APERture 
&SCALCulate [4 [2] :GDAPerture:SPAN 
CALCulate[1|2] :LIMit:STATe 
CALCulate [112] :LIMit:STATe? 
CALCulate [1 }2] :MATHE:EXPRession] 
CALCulate[1[2] :MATH[:EXPRession]? 


CALibration:ZERO:AUTO 
CALibration: ZERO: AUTO? 


DISPlay:CMAP:COLor[112]... 16] :HSL 
DISPlay:CMAP:COLor [112]... 16] :HSL? 
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DISPlay:CMAP:COLor[il2[... 


DISPlay: CMAP : DEFault 


16] :2GB 
DISPLay:CMAP:COLor[1]2] ... 16]: RGB? 


DISPlay:MENU[112] :KEY[i12] ... 7]? 


DISPLay :WINDow[1[2110] :GEOMetry 
DISPlay: WINDow[112|10] :GEOMetry 
DISPlay : WINDow[1]2110] :GEOMetry 
DISPLlay: WINDow[1]2]10]:GRAPhics 
GRAPhics 
DISPLay : WINDow[1]2/10]:GRAPhics 


DISPLay: WINDow[1[2110]: 


:LLEFT? 

: SIZE? 
:URIGHT? 
:CLEar 
:COLor 
:COLor? 


DISPlay :WINDow[112110]:GRAPhics[:DRAW] 


DISPLay : WINDow[1[2]10. 
DISPLay : WINDow[112110. 
DISPlay: WINDow[1[2/10. 


:GRAPhics : LABel 
:GRAPhics: MOVE 
:GRAPhics : MOVE? 


DISPlay :WINDow[1]2|10]:GRAPhics :STATe? 


DISPlay :WINDow[1|2] :TRACe:GRATicule:GRID[:STATe] 
DISPLay :WINDow[1|2] :TRACe:GRATicule:GRID[:STATe]? 
DISPlay :WINDow[1]2]:TRACe[1]2][:STATe] 

DISPLay : WINDow[1]2] : TRACe[1|2] [:STATe]? 


DISPLay: WINDow[1[2] 


DISPlay:WINDow[1[2] : TRACe: 
:TRACe: 
DISPlay :WINDow[1[2] :TRACe: 
DISPLay:WINDow[1[2] :TRACe: 


DISPlay: WINDow[112] 


FORMat :BORDer 
FORMat : BORDer? 
FORMat [: DATA] 
FORMat [: DATA]? 


:TRACe: 
DISPlay :WINDow[1[2] :TRACe: 
DISPLay : WINDow[1[2] :TRACe: 


VO: 
¥C: 
YC: 
Yikes 
VE: 
YE: 
YE: 


SCALe] 
SCALe] 
SCALe] 
SCALe] 
SCALe] 
SCALe] 
SCALe] 


:AUTO 
:PDIVision 
:PDIVision? 
:RLEVel 
?RLEVel? 
:RPOSition 
:RPOSition? 
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HCOPy : ABORt 

HCOPy :DEVice[1[213] 
HCOPy :DEVice[1[2{3] 
HCOPy :DEVice[11213] 
HCOPy :DEVice[11213] 
HCOPy :DEVice[11213] 
HCOPy :DEVice[1[2|3] 
HCOPy :DEVice[1[213] 
HCOPy :DEVice[11213] 
HCoPy[:IMMediate] 


:COLor 
:COLor? 
:LANGuage 
:LANGuage? 
:MODE 

:MODE? 
:RESolution 
:RESolution? 


HCOPy : ITEM: ANNotation:STATe 
HCOPy : ITEM: ANNotation:STATe? 
HCOPy : ITEM(1!2]3]:FFEed:STATe 
HCOPy : ITEM(1{213] :FFEed:STATe? 


INITiate[i|]2] :CONTinuous 
INITiate[i]2] :CONTinuous? 
INITiate[112] [:IMMediate] 


MMEMory: 
MMEMory: 
MMEMory: 
MMEMory: 
MMEMory: 
MMEMory: 
MMEMory: 
MMEMory: 
MMEMory: 
MMEMory: 
MMEMory: 


CATalog? 
cDIRectory 


COPY 
DELete 
FILE: INFO? 
INITialize 
LOAD : STATe 
MOVE 

MSIS 
MSIS? 


CDI Rectory? 


MMEMory: 
MMEMory: 
MMEMory: 
MMEMory: 


STORe:STATe 
STORe: TRACe 
TRANsfer :BDAT 
TRANsfer[:HFS] 


OUTPut [:STATe] 
OQUTPut [:STATe]? 


SCP! Conformance Information 
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PROGram:CATalog? 
PROGram[:SELected] :DEFine 
PROGram[:SELected] :DEFine? 
PROGram[:SELected] :DELete: ALL 
PROGram[:SELected] :DELete[:SELected] 
PROGram[:SELected] :EXECute 
PROGram[:SELected] :MALLocate 
PROGram[:SELected] :MALLocate? 
PROGram[:SELected] :NAME 
PROGram[:SELected] :NAME? 
PROGram[:SELected] :NUMBer 
PROGram[:SELected] :NUMBer? 
PROGram[:SELected] :STATe 
PROGram[:SELected] :STATe? 
PROGram[:SELected] :STRing 
PROGram[:SELected] :STRing? 
PROGram[:SELected] :WAIT 
PROGram[:SELected] :WAIT? 


SENSe[1]2] : AVERage :COUNt 


SENSe[1|2] :AVERage :COUNt? 

SENSe[1|2] : AVERage [:STATe] 

SENSe[1|2] : AVERage [:STATe]? 

SENSe [112] :BWIDth[:RESolution] 
SENSe[1]2] :BWIDth[:RESolution]? 

SENSe [112] :CORRection:COLLect [:ACQuire] 
SENSe[1]2] :CORRection:COLLect :METHod 
SENSe [112] :CORRection:COLLect :SAVE 
SENSe [112] :CORRection:CSET[:SELect] 
SENSe [112] :CORRection:CSET[:SELect]? 
SSSENSe [112] :CORRection:EDELay: TIME 
SDSENSe [1 12] :CORRection:IMPedance: INPut :MAGNitude 
SBSENSe [1/2] :CORRection:OFFSet : PHASe 
SBSENSe [112] :CORRection:RVELocity :COAX 
SENSe [112] :CORRection[:STATe] 
SENSe[1[2] :CORRection[:STATe]? 
SENSe([1|2] :DETector[: FUNCTION] 

SENSe [1/2] :FREQuency:CENTer 

SENSe [112] : FREQuency:CENTer? 

SENSe [1 [2] : FREQuency: SPAN 
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SENSe[1|2] :FREQuency : SPAN? 
SENSe [1/2] : FREQuency :STARt 
SENSe[1|2] :FREQuency :STARt? 
SENSe [1|2] :FREQuency :STOP 
SENSe [1/2] :FREQuency : STOP? 
SENSe[1|2] : FUNCtion 
SENSe[1]2] :FUNCtion? 

SENSe :ROSCillator:SOURce 
SENSe :ROSCillator:SOURce? 
SENSe[1|2] :SWEep :POINts 
SENSe[1|2] :SWEep:POINts? 
SENSe[1|2] :SWEep : TIME 
SENSe[1|2] :SWEep: TIME? 
SENSe[1|2] :SWEep:TIME: AUTO 
SENSe [1 |2] :SWEep: TIME: AUTO? 


soURce[1[2] :POWer[:LEVel] [: IMMediate] [:AMPLitude] 
SOURce[1}2] :POWer[:LEVel] [:IMMediate] [:AMPLitude]? 
SOURce[1}/2] :POWer:RANGe 

SOURce[112] :POWer:STARt 

SOURce[1|2] :POWer:STOP 


STATus : OPERation:CONDition? 
STATus: OPERat ion :ENABle 

STATus: OPERation:ENABle? 

STATus : OPERation[:EVENt]? 
STATus: OPERation :NTRansition 
STATus: OPERation:NTRansition? 
STATus: OPERation:PTRansition 
STATus : OPERation:PTRansition? 
STATus : QUEStionable:CONDition? 
STATus : QUEStionable:ENABle 
STATus : QUEStionable:ENABle? 
STATus: QUEStionable[:EVENt]? 
STATus : QUEStionable:NTRansition 
STATus : QUEStionable:NTRansition? 
STATus : QUEStionable:PTRansition 
STATus : QUEStionable:PTRansition? 


SYSTem:BEEPer [: IMMediate]? 
SYSTem:BEEPer : VOLume 
SYStTem:BEEPer : VOLume? 
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SYSTem 


SYSTem: 
SYSTem: 
SYSTem: 
SYSTem: 
SYSTem: 
SYSTem: 
SYSTem: 
SYSTem: 
SYSTem: 
SYSTem: 
SySTem: 
SYSTem: 
SYSTem: 


TRACe[: 
TRACe[: 


:COMMunicate:GPIB[:SELF] : ADDRess 


COMMunicate:GPIB[:SELF] :ADDRess? 
COMMunicate:SERial : TRANsmit :BAUD 
COMMunicate:SERial:TRANsmit :BAUD? 
DATE 

DATE? 

ERRor? 

KEY[:VALue] ? 

PRESet 

SET 

SET: LRN? 

TIME 

TIME? 

VERSion? 


DATA] 
DATAI? 


TRIGger [:SEQuence] :SOURce 
TRIGger [:SEQuence] :SOURce? 
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The following are instrument specific commands implemented by the 
HP 8711C/12C/18C/14C RF Network Analyzers which are not part of the 
present SCPI 1996.0 definition. 


CaLCulate[1|2] 
CALCulate[1[2] 
CALCulate [112] 
CALCulate[1i 12] 
CALCulate [1/2] 
CALCulate [112] 
CALCulate[i[2] 
CALCulate [112] 
CALCuLate [112] 
CALCulate[1|2] 
CALCulate[1|2] 
CALCulate [412] 
CALCulate [1 [2] 


CALCulate[1]2] 


CALCulate [1 [2] 
CALCulate [112] 
CALCulate [1/2] 
CALCulate [112] 
CALCulate[112 
CALCulate [112] 
CaLCulate [112] 
CALCulate [12] 
CALCulate [112] 
CALCulate[1{2] 
CALCulate[1|2] 
CALCulate[1|2] 
CALCulate [112] 
CALCulate [14/2] 
CALCuLate[1|2] 
CALCulate [1/2] 
CALCulate [112] 
CALCulate [4/2] 
CaLCulate [1/2] 


:FORMat : UNIT: MLIN 
:FORMat : UNIT: MLIN? 
:FORMat : UNIT: MLOG 
:FORMat : UNIT: MLOG? 
:LIMit : DISPlay 
:LIMit:DISPlay? 
:LIMit :MARKer :FLATness:MAXimum 
:LIMit :MARKer :FLATness:MINimum 
:LIMit :MARKer :FLATness[:STATe] 

:LIMit :MARKer : FREQuency : MAXimum 
:LIMit :MARKer :FREQuency : MINimum 
:LIMit :MARKer:FREQuency[:STATe] 
:LIMit :MARKer :STATistic: MEAN: MAXimum 
:;LIMit :MARKer :STATistic:MEAN:MINimum 
CALCulate[1|2]: 
:LIMit :MARKer :STATistic: PEAK: MAXimum 
:LIMit :MARKer :STATistic: PEAK: MINimum 
:LIMit :MARKer :STATistic:PEAK(:STATe] 
:LIMit :MARKer : TILT: MAXimum 

:LIMit :MARKer : TILT: MINimum 

:LIMit :MARKer : TILT[:STATe] 
:LIMit :SEGMent [112 
:LIMit :SEGMent [112 
:LIMit :SEGMent [112 
:LIMit :SEGMent [1/2 
:LIMit :SEGMent 
:LIMit :SEGMent [112] ... 12] 
:LIMit :SEGMent [112 


LIMit :MARKer :STATistic:MEAN[:STATe] 


:AMPLitude:STARt 
:AMPLitude:STARt? 
:AMPLitude: STOP 
:AMPLitude: STOP? 


sia hd 
... 12] 
12] 
.. 12] 
:AOQFF 

:FREQuency:STARt 


. 12] :FREQuency:STARt? 


:LIMit :SEGMent [112]... 12] :FREQuency:STOP 
:LIMit:SEGMent[1]2] ... 12] :FREQuency: STOP? 
:LIMit :SEGMent [112] ... 12] :POWer :STOP 
:LIMit:SEGMent [112] ... 12] :POWer:STOP? 
:LIMit:SEGMent [112] ... 12] :STATe 

:LIMit :SEGMent [1/2] ... 12] :STATe? 


13-9 


SCP! Contormance Information 
Instrument Specific Commands 


CALCulate[1 [2] 
CALCulate[1|2] 


CALCulate[4 [2]: 
:MARKer : BWIDth 


cALCulate [1/2] 


CALCulate [112]: 
:MARKer : FUNCtion:RESult? 


CALCulate [1 [2] 


caLCulate[il2]: 
:MARKer : FUNCtion[:SELect]? 
:MARKer : FUNCtion: TRACking 


CALCulate [112] 
cALCulate [112] 


CALCulate[i|2]: 


:LIMit :SEGMent [112]... 
:LIMit:SEGMent [1/21 ... 


12] : TYPE 
12] : TYPE? 
MARKer: AOFF 

MARKer : BWIDth? 


MARKer : FUNCtion[:SELect] 


MARKer : FUNCtion : TRACking? 


@caLCulate[1|2] :MARKer[112! ... 8]:GDELay? 


CALCulate [112] 
CALCulate [112] 
CALCulate[1]2] 
CALCulate [112] 
CALCulate [1 |2] 
CALCulate[i[2] 
CALCulate[1|2] 
CALCulate [112] 
CALCulate [1/2] 
CaLCulate [112] 
CALCulate [1/2] 
CALCulate [14 |2] 
caLCulate [112] 
CALCulate [1/2] 
CALCulate [1/2] 
CALCulate [1/2] 
CALCulate [1/2] 
CALCulate [112] 
CALCulate[1|2] 
CALCulate [12] 
CALCulate [112] 
CALCulate[1]2] 


CALCulate [112] 


:MARKer [112] a 81:% 


:MARKer [1/2] 8] 


:MARKer [112 ... 8] :MAXimum 
:MARKer [112] ... 8] :MAXimum:LEFT 
:MARKer [112| ... 6]:MAXimum: RIGHt 
:MARKer[1/2[ ... 8]:MINimum 
:MARKer [1/21 ... 8]:MINimum:LEFT 
:MARKer[i[2| ... 8]:MINimum:RIGHt 
:MARKer : MODE 

:MARKer : MODE? 

:MARKer : NOTCh 

:MARKer [1/2] ... 8]:POINt 

:MARKer [112]... 8]:POINt? 
:MARKer :REFerence:X? 

:MARKer : REFerence :Y? 

:MARKer [112] ... 8] [:STATe] 
:MARKer[1/2] ... 8] [:STATe]? 
:MARKer[1]2| ... 8]: TARGet 
:MARKer [112 . 8]: TARGet? 


:MARKer [112] ... 8]:X? 

:MARKer [112]... 8]:X:ABS 

:MARKer [1121]... 81:Y? 
:MARKer[il2l ... 8]:¥:INDuctance? 


:Y:MAGNitude? 


SB CALCulatel1|2]:MARKer [1121 ... 8] :¥:PHASe? 


2| ... 8]:¥:REACtance? 
2| ... 8]:Y:RESistance? 


SBCALCuLate[1[2] :MARKer [1 
SBCALCulate [112] :MARKer [1 


CALibration:SELF 
CALibration:SELF : TIMER 
CALibration:SELF: ALL 
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CONFigure 
CONFigure? 
CONTrol[1[2] :MULTiport : STATE 


DIAGnostic:CCONstants: INSTalled? 
DIAGnostic:CCONstants : LOAD 

DIAGnostic:CCONstants :STORe: DISK 
DIAGnostic:CCONstants : STORe: EEPRom 
DIAGnostic:COMMunicate:LAN:PING: IMM (Option 1F7 only) 
DIAGnostic:COMMunicate:LAN:PING:IPADress (Option IF7 only) 
DIAGnostic:COMMunicate: LAN:SEND (Option 1F7 only) 
DIAGnostic:MDISplay[1|]2] :CORRection C_DIRECT 
DIAGnostic:MDISplay[1]2] :CORRection C_ISOLATION 
DIAGnostic:MDISplay[1]2]:CORRection C_LDMATCH 
DIAGnostic :MDISplay[1|2]:CORRection C_RTRACKING 
DIAGnostic:MDISplay[1|2] :CORRection C_SRCMATCH 


DIAGnostic:MDISplay [112] :CORRection C_TTRACKING 
DIAGnostic:MDISplay [112] 


:CORRection I_DIRECTivity 
DIAGnostic:MDISplay [112] :CORRection I_RESPONSE 
DIAGnostic:MDISplay [112] :CORRection ILSRCMATCH 
DIAGnostic:MDISplay [112] :CORRection I_TRACKING 
DIAGnostic:MDISplay[i|2]:CORRection M_DIRECTivity 
DIAGnostic:MDISplay[i]2] : CORRection M_RESPONSE 
DIAGnostic:MDISplay[i[2]:CORRection M.SRCMATCH 
DIAGnostic:MDISplay[1]2] :CORRection M_TRACKING 
DIAGnostic:MDISplay[1[2]:CORRection M_XSCALAR 
DIAGnostic:MDISplay[1]2] :REST 
DIAGnostic:DITHer 
DiAGnostic:DITHer? 

DIAGnostic: SNUMber 
DIAGnostic:SNUMber? 
DIAGnostic: SPUR; AVDid 
DIAGnostic:SPUR:AVOid? 


& indicates HP 8712C/14C only 13-11 


SCP Contormanc 


2 Information 


Instrument Specific Commands 


DISPlay: 
DISPlay: 
DISPlay: 
DISPlay: 
DISPlay: 
DISPlay: 
DISPlay: 
DISPlay: 
DISPlay: 
DISPlay 
DISPlay: 
DISPlay: 
DISPlay 


DISPlay 
DISPlay: 
DISPlay: 
DISPlay: 
DISPlay 
DISPlay: 
DISPlay: 
DISPlay: 
DISPlay: 
DISPlay: 
DISPlay: 
DISPlay 
DISsPlay: 
DISPlay 
DISPlay: 
DISPlay: 
DISPlay: 
DISPlay 
DISPlay: 
DISPlay: 
DISPlay: 
DISPlay: 
DISPlay: 
DISPlay: 
DISPlLay: 
DISPlay: 
DISPlay: 


ANNotation: 
ANNotation: 
ANNotation: 
ANNotation: 
ANNotation: 
ANNotation: 
ANNotation: 
ANNotation: 
ANNotation: 


:ANNotation: 


ANNotation: 
ANNotation: 


:ANNotation: 
:ANNotation: 


ANNotation: 
ANNotation: 
ANNotation: 


:AWNotation: 


ANNotation: 
ANNotation: 
ANNotation: 
ANNotation: 
AllNotation: 
ANNotation: 


:ANNotation: 


ANNotation: 


:ANNotation: 


ANNotation: 
ANNotation: 
ANNotation: 


:ANNotation: 


ANNotation: 
ANNotation: 
ANNotation: 
ANNotation: 
ANNotation: 
ANNotation: 
ANNotation: 
ANNotation: 
ANNotation: 


CHANnel [1/2] [:STATe] 
CHANnel [1|2] :USER:LABel [: DATA] 
CHANnel [12] :USER[:STATe] 
CLOCK : DATE: FORMat 
CLOCK : DATE: FORMat? 
CLOCK: DATE : MODE 
CLOCK : DATE: MODE? 
CLOCk : MODE 

CLOCk : MODE? 

CLOCk : SEConds [:STATe] 
CLOCk : SEConds[:STATe]? 
FREQuency [1/2] :MODE 
FREQuency [112] : MODE? 


FREQuency : RESolution 
FREQuency : RESolution? 
FREQuency[1!2] [:STaTe] 
FREQuency [112] :USER:LABel [: DATA] 
FREQuency[1|2] :USER:STARt 
FREQuency [112] :USER[:STATe] 
FREQuency [1] 2] :USER:STOP 
FREQuency[1|2] :USER: SUFFIX 
LIMit : ICON[1|2] : FLAG 

LIMit : ICON[1|2] :POS:X 
LIMit :ICON(112]:POS:Y 

LIMit : ICON[1|2] : TEXT 

LIMit : IcON[1|2] :sTATe 
MARKer [1] 2] :NUMBers[:STATe] 
MARKer [112] [:sTaTe] 
MARKer [112] [:STATe]? 
MESSage: AOFF 

MESSage: CLEar 
MESSage[:DATA]? 
MESSage:STATe 
MESSage:STATe? 

TITLe [112] :DATA 

TITLe[1]2] :DATA? 
TITLe[:STATe] 
TITLe[:STATe]? 

YAXis : MODE 

YAXis : MODE? 
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DISPLay : ANNotation: YAXis[:STATe] 

DISPLay : ANNotation: YAXis[:STATe]? 
DISPlay:CMAP:COLor[1/2] ... 16] :GREYscale 
DISPLay : CMAP : SCHeme 

DISPLay : FORMat 

DISPlay : FORMat? 

DISPlay : FORMat : EXPAND 

DISPLay : MENU: RECall : FAST[:STATe] 

DISPLay : PROGram[ : MODE] 
DISPlay : PROGram[ :MODE]? 

DISPlay : WINDow:GRAPhics : BUFFer [:STATe] 
DISPLay : WINDow:GRAPhics:BUFFer[:STATe]? 
DISPlay : WINDow[112| 10] :GRAPhics:CIRCle 
DISPlay : WINDow[1|2| 10] :GRAPhics:LABel : FONT 
DISPLay : WINDow[1|2/10] :GRAPhics:LABel : FONT? 
DISPlay : WINDow[i12[10] :GRAPhics:RECTangle 
DISPlay : WINDow[1/2/10] :TRACe[1|2] :Y: TRACK 


HCOPy: 
HCOPy 
HCOPy: 
HCOPy: 
HCOPy: 
HCOPy 
HCOPy: 
HCOPy: 
HCOPy: 
HCOPy: 
HCOPy: 
HCOPy: 
HCOPy: 
HCOPy: 
HCOPy: 
HCOPy: 
HCOPy: 
HCOPy: 
HCOPy: 
HCOPy: 
HCOPy: 
HCOPy: 


DEVice: PAGE: MARGin: LEFT 


:DEVice:PAGE:MARGin:TOP 


DEVice:PAGE:0RIentation 
DEVice:PAGE:WIDTh 
DEVice:PORT 


:DEVice:PORT? 


ITEM: GRATicule:STATe 
ITEM: GRATicule:STATe? 
ITEM: MARKer :STATe 
ITEM: MARKer :STATe? 
ITEM: TITLe:STATe 
ITEM: TITLe :STATe? 
ITEM: TRACe:STATe 
ITEM: TRACe :STATe? 
PAGE: MARGin: LEFT 
PAGE: MARGin: LEFT? 
PAGE: MARGin: TOP 
PAGE: MARGin: TOP? 
PAGE: ORIentation 
PAGE: ORI entation? 
PAGE: WIDTh 

PAGE: WIDTh? 
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INPut : GAIN: AUTO 
INPut : GAIN: SETTing 


MMEMory 
MMEMory: 
MMEMory 
MMEMory: 
MMEMory 
MMEMory : 
MMEMory: 
MMEMory 
MMEMory 
MMEMory 
MMEMory 
MMEMory 
MMEMory : 


RoUTe [11 
RoUTe [11 


SENSe [1] 
SENSe [11 
SENSe [1] 
SENSe [11 
SENSe [1] 
SENSe [1] 
SENSe [1] 
SENSe [1] 
SENSe [1 
SENSe [11 
SENSe [11 
SENSe 
SENSe 


:MDIRectory 


RDIRectory 


:STORe: 
iSTATe: 
:STORe : 
:STATe: 
: TRACe 
:STATe: 
:STATe: 
:TRACe 


STORe 


STORe 


STORe : 
:STORe 
:STORe 
:STORe 
:STORe: 
:TRANsfer: BDAT 


STATe 


STATe 


STATe 


TRACe 


:CORRection 


CORRection? 


:1STate 


ISTate? 


TRACe? 
TSCAL 


7 FORMat 


TRANsfer[:HFS] 
PowWer\[1]2] :MODE 


2] :REFLection:PATH:DEFine:PORT 
2] : TRANsmission:PATH:DEFine: PORT 


2] :AVERage :CLEar 

2] :CORRect ion: CAPacitance:CUNNector (Option 100 only) 
2] :CORRection:CAPacitance:CONNector? (Option 100 only) 
2] :CORRection:COLLect : ABORt 

2) :CORRection:COLLect :CKIT[:SELect] 

2] :CORRection:COLLect :CKIT[:SELect] ? 

2] :CORRection:COLLect :1STate[: AUTO] 

2] :CORRection:COLLect :ISTate[:AUTO]? 

2] :CORRection:COLLect : PORTS 

2) :CORRection:COLLect :MP:0PEN 

2] :CORRection: COLLect :MP:SHORT 


[12] :CORRection:COLLect :MP: LOAD 
41/2] :CORRection:COLLect :MP: THRU 


SENSe[1]2] :CORRection:COLLect: VERify : TRANsmission 
SENSe[1]2] :CORRection:COLLect: VERify :REFLection 
@SENSe [112] :CORRect ion: EXTension[:STATe] 

@SENSe [1|2] :CORRection:EXTension:REFLection[:TIME] 
SSENSe [112] :CORRection:EXTension: TRANsmission[:TIME] 
SENSe[1]2] :CORRection:IMPedance:INPut :MAGNitude :SELect 
SENSe [1/2] :CORRect ion: LENGth: COAX (Option 100 only) 
SENSe[1[2] :CORRection:LENGth: COAX? (Option 100 only) 
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SENSe [112] :CORRect ion: LENGth:CONNector (Option 100 only) 

SENSe [112] :CORRection:LENGth:CONNector? (Option 100 only) 
SENSe [112] :CORRection:LOSS:COAX (Option 100 only) 

SENSe [1/2] :CORRection:LOSS:COAX? (Option 100 only) 

SENSe [1|2] :CORRection :MODel:CONNector[:IMMediate] (Option 100 
only) 


SENSe[1|2] : CORRect ion: PEAK: COAX (Option 100 only) 

SENSe [1/2] : CORRection:PEAK:COAX? (Option 100 only) 

SENSe [1}2] :CORRection:RVELocity[:IMMediate] (Option 100 only) 
SENSe [1/2] :CORRection: TESTSET 

SENSe [1|2] :CORRection:THReshold:C0AX (Option 100 only) 
SENSe[1|2] :CORRection:THReshold:COAX? (Option 100 only) 

SENSe :COUPle 

SENSe :COUPle? 

SENSe[1[2] :DETector[:FUNCtion] 


& indicates HP 87120/14€ only 18-15 


SCP! Conformance information 
Instrument Specific Commands 


SENSe [112] :DETector[:FUNCtion]? 

SENSe :DISTance:STARt (Option 100 only) 

SENSe :DISTance:STARt? (Option 100 only) 

SENSe :DISTance:STOP (Option 100 only) 
SENSe:DISTance: STOP? (Option 100 only) 

SENSe : DISTance: UNITs (Option 100 only) 
SENSe:DISTance:UNITs? (Option 100 only) 

SENSe : FREQuency : MODE (Option 100 only) 

SENSe : FREQuency : MODE? (Option 100 only) 
SENSe:FREQuency :SPAN:MAXimum? (Option 100 only) 
SENSe : FREQuency : SPAN: MAXimum (Option 100 only) 
SENSe : FREQuency : ZSTop (Option 100 only) 
SENSe:FREQuency :ZSTop? (Option 100 only) 

SENSe : FUNCtion: SRL: IMPedance (Option 100 only) 
SENSe:FUNCtion:SRL:IMPedance? (Option 100 only) 
SENSe : FUNCtion: SRL :MODE (Option 100 only) 

SENSe : FUNCtion: SRL: MODE? (Option 100 only) 

SENSe :FUNCtion:SRL:SCAN[:INMediate] (Option 100 only) 
SENSe [112] :STATe 

SENSe [1/2] :STATe? 

SENSe : SWEep : TRIGger : SOURce 

SENSe : SWEep : TRIGger :SOURce? 

SENSe :WINDow[: TYPE] (Option 100 only) 

SENSe :WINDow[: TYPE]? (Option 100 only) 


STATus : DEVice:CONDition? 

STATus : DEVice: ENABle 

STATus : DEVice: ENABle? 

STATus : DEVice[:EVENt]? 

STATus : DEVice:NTRansition 

STATus : DEVice:NTRansition? 

STATus : DEVice:PTRansition 

STATus : DEVice:PTRansition? 

STATus : OPERat ion: AVERaging: CONDition? 
STATus : OPERation : AVERaging: ENABle 
STATus : OPERation: AVERaging: ENABlLe? 
STATus : OPERat ion: AVERaging[ :EVENt]? 
STATus : OPERation:AVERaging: NTRansition 
STATus : OPERat ion: AVERaging: NTRansition? 
STATus : OPERat ion : AVERaging:PTRansition 
STATus : OPERat ion : AVERaging:PTRansition? 
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STATus :OPERation:MEASuring:CONDition? 
STATus :OPERat ion : MEASuring: ENABle 
STATus :OPERation : MEaSuring:ENABle? 
STATus :OPERat ion :MEASuring[ :EVENt]? 
STATus :OPERat ion :MEASuring:NTRansition 
STATus :OPERation:MEASuring:NTRansition? 
STATus :OPERation:MEASuring:PTRansition 
STATus :OPERation:MEASuring:PTRansition? 
STATus :PRESet 

STATus :QUEStionable:LIMit :CONDition? 
STATus :QUEStionable: LIMit :ENABle 

STATus :QUEStionable:LIMit :ENABle? 
STATus :QUEStionable:LIMit [:EVENt]? 
STATus :QUEStionable:LIMit :NTRansition 
STATus :QUEStionable:LIMit :NTRansition? 
STATus :QUEStionable:LINit :PTRansition 
STATus :QUEStionable:LIMit :PTRansition? 


SYSTem:COMMunicate:GPIB:CONTroller[:STATe] 
SYSTem:COMMunicate :GPIB:CONTroller[:STATe]? 
SYSTem:COMMunicate : GPIB: ECHO 

SYSTem:COMMunicate: GPIB: ECHO? 

SYSTem:COMMunicate :GPIB:HCOPy: ADDRess 
SYSTem:COMMunicate:GPIB:HCOPy: ADDRess? 
SYSTem:COMMunicate:GPIB:MMEMory:ADDRess 
SYSTem:COMMunicate :GPIB:MMEMory :ADDRess? 
SYSTem:COMMunicate : GPIB :MMEMory :UNIT 
SYSTem:COMMunicate:GPIB:MMENory :UNIT? 
SYSTem:COMMunicate : GPIB :MMEMory : VOLume 
SYSTem:COMMunicate : GPIB :MMEMory :VOLume? 
SYSTem:COMMunicate : GPIB :MMEMory :VOLume? 
SYSTem:COMMunicate:LAN:EADDress? (Option 1F7 only) 
SYSTem:COMMunicate:LAN:IPADdress (Option IF7 only) 
SYSTem:COMMunicate:LAN:IPADdress? (Option 1F7 only) 
SYSTem:COMMunicate :LAN:PRINter :HOSTname (Option LF’ only) 
SY¥STem:COMMunicate:LAN:PRINter:HOSTname? (Option 1F7 only) 
SYSTem:COMMunicate :LAN:ROUTe:GATeway (Option 1F7 only) 
SYSTem:COMMunicate:LAN:ROUTe:GATeway? (Option IF7 only) 
SYSTem:COMMunicate:LAN:ROUTe :SMASk (Option 1F7 only) 
SYSTem:COMMunicate:LAN:ROUTe:SMASK? (Option 1F7 only) 
SYSTem: COMMunicate:LAN:STATe (Option 1F7 only) 
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SYSTem:COMMunicate :LAN:STATe? (Option 1F7 only) 
SYSTem: COMMunicate :SERial : TRANsmit :HANDshake 
SYSTem: COMMunicate :SERial : TRANsmit :HANDshake? 
SYSTem: COMMunicate : TTL: USER: FEED 

SYSTem: COMMunicate :TTL:USER: FEED? 

SYSTem: KEY : MASK? 

SYSTem: KEY : QUEue:CLEar 

SYSTem: KEY : QUEue : COUNt? 

SYSTem: KEY : QUEue :MAXimum? 

SYSTem: KEY : QUEue[:STATe] 

SYSTem: KEY :QUEue[:STATe]? 

SYSTem: KEY : TYPE? 

SYSTem: KEY : USER 

SYSTem:SET:LRNLong 


TEST: RESult? 
TEST :SELect 
TEST: SELect? 
TEST: STATe 
TEST :STATe? 
TEST: VALue 
TEST : VALue? 
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SCPI Error Messages 


This chapter contains the same error message information that can be found 
in the SCPI 1994 Volume 2: Command Reference. There are four sections in 
this chapter: 


e Command Errors 

« Execution Errors 

« Device-Specific Errors 
e Query Errors 


NOTE 


Your analyzer does not use all ef the error messages listed in this chapter. 
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Command Errors 


An error/event number in the range —199 to —100 indicates that an 

IEEE 488.2 syntax error has been detected by the instrument’s parser. The 
occurrence of any error in this class shall cause the command error bit (bit 5) 
in the event status register (IEEE 488.2, section 11.5.1) to be set. One of the 
following events has occurred: 


e An IEEE 488.2 syntax error has been detected by the parser. That is, a 
controller-to-device message was received which is in violation of the 
IEEE 488.2 standard. Possible violations include a data element which 
violates the device listening formats or whose type is unacceptable to the 
device. 


e An unrecognized header was received. Unrecognized headers include 
incorrect device-specific headers and incorrect or unimplemented 
IEEE 488.2 common commands. 


e A Group Execute Trigger (GET) was entered into the input buffer inside of 
an IEEE 488.2 program message. 


Events that generate command errors shall not generate execution errors, 
device-specific errors, or query errors; see the other error definitions in this 
chapter. 
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Table 14-1. SCPI Command Errors 


i 
| Error Number Error Description 

100 Command error — This is the generic syntex error for devices that cannot detect more specific errors. This code 
indicates only that a Command Error has occurred. 

~101 Invalid character -- A syntactic element contains @ charecter which is invalid for that type; for exemple, a header 
containing an ampersand, SETUP&. This error might be used in place of errors 114, —121, —141, and perhaps 
some others. 

—i02 Syntax error — An unrecognized command or data type was encountered; for example, a string was received when 
the device does not accept strings. 

—183 Invalid separator — The parser was expecting a separator and encountered an legal character; for example, the 
semicolon wes omitted after a program message unit, ¥EMC 1:CHi:VOLTS 5. 

—104 Data type errer — The parser recognized a data element different than one allowed; for example, numeric of string 
data wes expected but block data wes encountered. 

—105 GET not allowed — A Group Execute Trigger was received within @ program message. 

— {08 Parameter not allowed — More parameters were received than expected for the header; for example, the EMC 
common command only accepts one parameter, so receiving EMC O, 1 is not allowed. 

—109 Missing parameter — Fewer parameters were received than required for the header; for example, the ¥ENC 
common command requires one parameter, so receiving *EMC is not allowed. 

—110 Command header error ~ An error was detected in the header. This errer message should be used when the 
device cannot detect the more specific errors described for errors —111 through —118. 

—_——+ 

—11 Header separator error ~ A character which is not a legal header separator was encountered while parsing the 
header; for example no white space followed the header, thus *GMC"MACRO" js an error. 

442 Program mnemonic too long — The header contains more that twelve characters. 

-113 Undefined header — The header is syntactically correct, but it is undefined for this specific device; for exampie, 
¥XYZ jis not defined for any device. 

om Hd Header suffix out of range — The value of a numeric suffix attached to a program mnemonic mekes the header 
invalid. 

—120 Numeric deta error — This error, as well as errors — 121 through 129, are generated when parsing 2 data 
elememt which appears to be numeric, including the nandecimal numeric types. This particular error message should 
be used. if the device cannot detect a more specific error. 

—121 invalid character in number — An invalid character for the deta type being parsed was encountered; for exemple, an 
alpha in a decimal numeric or a “S" in octal data. 

—123 Exponent too large —- The magnitude of the exponent was larger than 32000. 
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Table 14-1. SCP Command Errors (continued) 


_ 
Errar Number Errer Description 
—124 Too many digits — The mantissa of a decimal numeric date element contained more than 266 digits excluding 
leading zeros. 
128 Numeric data not allowed ~ A legal numeric data element was received, but the device does not accept one in 
this position for the header. 
130 Suffix error — This error, as well as errors —131 through —139, are generated when parsing @ sulfix. This 
particular error message should be used if the device cannot detect a more specific error. 
tc 
—3t invalid suffix — The suffix does not follow the correct syntax, or the suffix is inappropriate for this device. 
Ranta 
—~ 134 Suffix too long ~ The suffix contained more than 12 characters. 
—18 Suttix not allowed — A suffix was encountered after a numeric element which does not allow suffixes. 
14 Character data error — This error, as well as errors —141 through —149, are generated when parsing @ character 
data element. This particular error message should be used if the device cannot detect ¢ more specific error. 
—141 Invalid character data — Either the character date element contains an invalid character or the particular element 


recaived is not valid for the header. 


—144 Character data toa long — The character data element contains more than twelve characters. 

—148 Character data not allowed — A legal character data element was encountered where prohibited by the device, _j 

— 150 String data error — This error, as well as errors 151 through ~159, are generated when parsing a string data 
element. This particular error message should be used if the device cannat detect a more specific error. 

—151 Invalid string data — A string data element was expected, but was invalid for some reason. for example, an END 
message was received before the terminal quote character. 

—158 String data not allowed — A string data element was encountered but was not allowed by the device at this point 
in parsing. 

— 160 Block data error ~ This error, as well es errors —161 through —169, are generated when parsing a block deta 
element. This partioular error message should be used if the device cannot detect a more specific error. 

oe | =| 

~~ 181 invalid block data — A block date element was expected, but was invalid for some reason. For example, an END 
message was received before the length was satisfied. 

—~ 168 Block date not allowed — A legal bleck data element was encountered but was not allowed by the device at this 
point in parsing. 

—170 Expression error — This error, as well 2s errors —171 through —179, are generated when parsing an expression 


dete element. This particuler error message should be used if the device cannot detect a more specific error, 
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Table 14-1. SCPI Command Errors (continued) 


Errer Number Error Description 

Ti Invalid expression — The expression date element was invalid (for example, unmatched parentheses or an illegal 
charecter!. 

78 Expression data not allowed — A legal expression deta was encountered but was not alowed by the device at this 
point in parsing. 

—180 Macro error — This error, as well as errors ~-181 through —189, are generated when defining or executing @ 
macro. This particular error message should be used if the device cannot detect a more specific error. 

——t 

181 Invalid outside macro definition — indicates that a macro parameter placeholder |S<number] was encountered 
outside of a macro definition. 

—183 invalid inside macro definition — Indicates that the program message unit sequence, sent with a *DDT or *DMC 
command, is syntactically invalid. 

— 184 Macro parameter error — Indicates that a command inside the macro definition had the wrong number or type of 
parameters. 
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Execution Errors 


An error/event number in the range —299 to —200 indicates that an error has 
been detected by the instrument’s execution control block. The occurrence of 
any error in this class shall cause the execution error bit (bit 4) in the event 
status register to be set. One of the following events has occurred: 


e A program data element following a header was evaluated by the device 
as outside of its legal input range or is otherwise inconsistent with the 
device’s capabilities. 

e A valid program message could not be properly executed due to some 
device condition. 


Execution errors shall be reported by the device after rounding and 
expression evaluation operations have taken place. Rounding a numeric data 
element, for exaraple, shall not be reported as an execution error. Events that 
generate execution errors shall not generate Command Errors, device-specific 
errors, or Query Errors; see the other error definitions in this section. 
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Table 14-2. SEP! Execution Errors 


Error Nem! 


—200 


ber Error Description 
Execution error — This is the generic syntax error for devices that cannot detect more specific errors. This code 


indicates only that an Execution Error has occurred. 


—2 Invalid white in focal — indicates thet 2 command is not executable while the device is in local due te a hard local 

control; far example, a device with a retary switch receives a message which would change the switches state, but 
_|the device is in local so the message can not be executed, 

—202 Settings inst due to rt! — Indicates that a setting associated with @ hard iscal control was lost when the device 

changed to LOCS from REMS or to [WLS from RWLS. ; 
— 

203 Command protected — indicates that a legal password-protected program command ar query could not be executed 
because the command was disabled 

20 Trigger error 
ip 

21 Trigger ignored — Indicates that a GET, *TRG, or triggering signal was received and recognized by a device but] 
| was ignored because of device timing considerations; for example, the device was not ready to respond. 

22 Arm ignored — Indicates that an arming signal was received and recognized by the device but was ignored. 

213 Init ignored — Indicates that a request for @ measurement initiation was ignered as another measurement was 
already in progress. 

~214 ‘Trigger deadlock ~ Indicates that the trigger source for the initiation of a measurement is set to GET and 
subsequent measurement query is received. The measurement cannot be started until a GET is feceived, but the 
GET would cause an INTERRUPTED error. 

~ 218s Arm deadlock ~ indicates that the arm source for the initiation of 2 measurement is set to GET and subsequent 
measurement query is received. The measurement cannot be started until a GET is received, but the GET would 
cause an INTERRUPTED error. 

~220 Parameter error — Indicates that a program data element related error occurred. This error message should be 
used when the device cannot detect the more specific errors —221 through —229. 

221 Settings conflict — indicates that a legal program data element was parsed but could not be executed due to the 
current device state. 

-22 Data out of range — Indicates that a legal program data element was parsed but could not be executed because 
the interpreted value was outside the legal range as defined by the device. 

223 Yoo much date — indicates thet e legal program data elememt of block, expression, or string type was received 
thet contained more data than the device could handle due to memory or related device-specific requirements. 

~~ 224 legal parameter value — Used where an exact velue, from a list of possible values, was expected. 


1 A OTO device always ignores GET and treats “TRG as 2 Command Error. 
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Table 14-2. SCPI Execution Errors (continued) 


Error Number Error Description 

24 Out of memory -- The device has insufficient memory to perform the requested operation. 

—226 Lists not same length ~ Attempted to use LIST structure having individual LIST’s of unequal lengths. 

—230 Data corrupt or stale — Possibly invalid data; new reading startad but not completed since last access. 

—231 Data questionable ~ indicates that measurement accuracy is suspect. 

—232 invalid format — indicates that a legal pragram date element was parsed but could not be executed because the 
data format or structure is inappropriate, such as when leading memory tables or when sending a SYSTem:SET 
parameter from an unknown instrument. 

~233 Invalid version — indicates that a legal program data element was parsed but could not be executed because the 
version of the data is incorrect to the device, This garticular error should be used when file or block data formats 
are recognized by the instrument but cannot be executed for reasons of version incompatibility. For example, an 
unsupported file version, ot an unsupported instrument version. 

—240 Hardware error — Indicates thet a legal program command or query could not be executed because of a hardware 
problem in the device. Definition of what constitutes a hardware problem is completely device-specitic. This error 
message should be used when the device cannot detect the more specific errors described for errors —241 through 
~ 249. 

24] Hardware missing — indicates that a legal pregram command or query could not be executed because of missing 
device hardware: fer examole, an option was net installed. Definition of what constitutes missing hardware is 
completely device-specific. 

20 Mass storage error ~ indicates that a mass storage error occurred. This error message should be used when the 
device cannot detect the more specific errors described for errors 251 through —259. 

251 Missing mass storage — Indicates that 2 legal program command or query could not be executed because of 
missing mass storage; for example, an option that was not installed. Definition of what constitutes missing mass 
storage is device-specific. 

~~ 262 Missing media — Indicates that a legal program command or query could not be executed because of a missing 
media; for example no disk. The definition of what constitutes missing media is device-specitic. 

Eaee eee | ———} 
~ 259 Corrupt media — Indicates that a legal program command or query could not be executed because of corrupt medial 
for example, bad disk or wrong format. The definition of whet constitutes corrupt media is device-specific, 

264 Media full -- Indicates that a legel program command or query could not be executed because the media was full; 
for example, there is no room on the disk. The definition of what constitutes a full media is device-specific. 

~ 205 Directory full — indicates that a legal program commend or query could not be executed because the media 


directory was full. The definition of what constitutes a full media directory is device-specific. 
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Table 14-2. SCPI Execution Errors (continued) 


Error Number Error Description 

—258 File name not found — Indicates that @ legal program command or query could not be executed because the file 
fame on the device media was not found: for example, an attempt was made to read or copy @ nonexistent file 
The definition of what constitutes a file not being found is device-specitic. 

27 File name error — Indicates that a legai program command or query could not be executed because the file name 
on the device media was in error; for example, an attempt was made to copy to a duplicate file name. The 
definition of what constitutes a file name error is device-specific 

~~ 258 Media protected — indicates that a legal program command or query could not be executed because the media 
was protected; for example, the write-protect tab on a disk was present. The definition of what constitutes 
protected media is device-specific. 

—260 Expression error — Indicates that an expression program data element related error occurred. This errar message 
should be used when the device cannot detect the mare specific errors described for errors —-261 through — 289. 

pees it 

—261 Math error in expression — Indicates that @ syntacticeliy legal expression program data element could not be 
executed due te a math error; for example, @ divide-by-zero was attempted. The definition of math error is 
device-specific. 

270 Macro error — Indicates that ¢ macre-related execution error occurred. This error message should be used when 
the device cannot detect the more specific errors 271 through —279. 

—27\ Macro syntax error — Indicates that 4 syntactically legal macro program data sequence could not be executed due 
to @ syntax error within the macro definition. 

—272 Macro execution error — Indicates that a syntactically legal macro program data sequence could not be executed 
due to some error in the macro definition. 

~273 filegal macro label — indicates that the macro label defined in the *DMC commend wes @ legal string syntax, but 
could not be accepted by the device; for example, the label was too long, the same as @ common command header, 
or contained invalid header syntax. 

= 

274 Macro parameter error ~ Indicates that the macro definition improperly used a macro parameter placeholder. 

~275 Macro definition too long ~ Indicates that a symactically legal macro program data sequence could not be executed 
because the string or block contents were too long for the device to handle. 

—276 Macro recursion error — Indicates that a syntactically legal macro program data sequence could not be executed 
because the device found it to be recursive. 
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Table 14-2. SCP] Execution Errars (continued) 


Error Number Error Description 

—277 Macro redefinition not allowed ~ Indicates that a syntactically legal macro label in the *DMC command could not | 
be executed because the macro label was already defined. 

~278 Macro header not found — Indicates that 2 syntactically legal macro label in the *GMC? query could not be 
executed because the header was not previously defined. 

280 Program error — Indicates that ¢ downloaded program-related execution error occurred. This error message should 
be used when the device cannot detect the more specific errors ~281 through —289. A downloaded program is 
used to add algorithmic capability to 2 device, The syntax used in the program and the mechanism for 
downloading a program is device-specific. 

~2i Cannot create program —- Indicates that an attempt to create @ program was unsuccessful. One reason for failure 
might include not enough memory. 

22 legal program name — The name used to reference a program was invalid; for example, redefining an existing 
program, deleting a nonexistent program, or in general, referencing a nonexistent program. 

~ 283 Illegal variable name — An attempt was made to reference 8 nonexstent variable in @ program. 

~ 204 Progrem currently running ~ Certain operations dealing with programs may be illegal while the pregram is running; 
for example, deleting a rufining program might not be possible. 

285 Program syntax error ~ Indicates that @ syntax error appeers in a downloaded program. ‘The syntax used when 
parsing the downloaded program is device-specific, 

~~ 286 Program runtime error 

~ 290 Memory use error — Indicates that a user request has directly or indirectly caused an error related te memory or 
data_handies (this is not the same as “bad” memory). 

—23i Out of memary 

~282 Referenced name does not exist 

a oneal 
293 Referenced name already exists 
294 Incompatible type — Indicates that the type or structure of a memory item js inadequate. 
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An error/event number in the range —399 to —300 or 1 to 32767 indicates 
that the instrument has detected an error which is not a command error, a 
query error, or an execution error. It indicates that some device operations 
did not properly complete, possibly due to an abnormal hardware or firmware 
condition. These codes are also used for self-test response errors. The 
occurrence of any error in this class should cause the device-specific error bit 
(bit 3) in the event status register to be set. 


The meaning of positive error codes is device-dependent and may be 
enumerated or bit mapped; the error message string for positive error codes 
is not defined by SCPI and available to the device designer. Note that the 
string is not optional; if the designer does not wish to implement a string 

for a particular error, the null string should be sent (for example, 42,”"). 

The occurrence of any error in this class should cause the device-specific 
error bit (bit 3) in the event status register io be set. Events that generate 
device-specific errors shall not generate command errors, execution errors, or 
query errors; see the other error definitions in this section. 


14-12 


SCP Error Messages 
Device-Specific Errors 


Table 14-3. SCP! Device-Specific Errors 


Error Number | Error Description 
ansiceen ee 

—300 | Device-specific error — This is the generic device-dependent error for devices that cannot detect more specific errors. 
This code indicates only that a Device-Dependent Error has occurred. 

—H0 System error — indicates that some error, termed “system error’ by the device, has occurred. This code is 
device-dependent. 

ne | ee 

—3it Memory errar — indicates that an error was detected in the device's memory. The scope of this error is 
device-dependent. 

312 PUD memory lost — Indicates that the protected user data saved by the *PUD command has been lost. 

313 Calibration memory lost — Indicates that nonvolatile calibration data used by the *CAL? commend has been lost. 

—314 Savelrecall memory fast ~- Indicates that the nonvolatile data saved by the *SAV? command has been lost. 

—318 Configuration memory lost — Indicates that nonvolatile configuration data saved by the device hes been lost. The 
meaning of this error is device-specific _| 

—330 Self-test failed 

—380 Queue overflaw — A specific code entered into the queue in lieu of the code that caused the error. This code 
indicates that there is ne room in the queue and an error cccutred but was not recorded. 

—360 Communicetion error — This is the generic communication error for devices that cannot detect the more specific 
errors —361 through —363. 

—361 Parity error in program message — Parity bit not correct when data received, for example, on a serial port. 

—362 Framing error in pregram message — A stop bit was not detected when data was received, for example, on a 
serial port [for example, a baud rate mismatch). 

—363 Input buffer overrun — Software or hardware input buffer on serial port overflows with deta caused by improper 
of nonexistent pacing. 
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Query Errors 


An error/event number in the range —-499 to —400 indicates that the output 
queue control of the instrument has detected a problem with the message 
exchange protocol. The occurrence of any error in this class shall cause the 
query error bit (bit 2) in the event status register to be set. These errors 
correspond to message exchange protocol errors. One of the following is true: 


e An attempt is being made to read data from the output queue when no 
output is either present or pending, 


e Data in the output queue has been lost. 


Events that generate query errors shall not generate command errors, 
execution errors, or device-specific errors; see the other error definitions in 
this section. 


Table 14-4. SCPI Query Errers 


Error Number Error Description 

400 Query error — This is the generic query error for devices that cannot detect more specific errors. This code 

indicates only that a Query Error has sccurred. 
{——— 

Aid Query INTERRUPTED ~~ indicates that a condition causing an INTERRUPTED Query error occurred; for 
example, a query folowed by DAB or GET before a response was completely sent. | 

—420 Query UNTERMINATED — Indicates that a condition causing an UNTERMINATED Query error sceurred; for 
example, the device was addressed to talk and an incomplete program message was received. 

430 Query DEADLOCKED ~ Indicates that a condition causing a DEADLOCKED Query error occurred; for example, 
both input butfer and output buffer are full and the device cannot continue, 

4A Query UNTERMINATED after indefinite response — Indicates that # query was received in the same program 


message after an query requesting an indefinite response was executed. 
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3.5 mm, 11-30 
BO @, 11-30 
75, 11-30 


A 11-6 
abbreviation 

of commands, 10-8 
Abort 

hardcopy, 11-37 
ABORt, 10-4, 12-2, 12-3 
Abort Cal, 11-24 
Abort CAL Check , 11-25 
active controller 

defined, 12 
Active Marker Off, 11-15 
Add Max Line, 11-18 
Add Max Point, 11-18 
‘Add Min Line, 11-18 
Add Min Point, 11-18 
address 

HP-IB, 1-2 
address capability, 1-7 
AHI, 1-8 
allocate memory, 12-25 
Alt BET, 11-16 
AL1 Stds Done, 11-24 
Alt Sweep on OFF, 11-11 
AM Delay, 11-6 

cal, 11-29 
ANNotation, 12-15, 12-16, 12-17 
Annotation ON off, 11-39 
aperture, delay, 11-82 
A/E, 11-6 
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arrays 
data, corrected, 6-25 
example program to up- and down-load, 8-53 
formatted, 6-27 
measurement, 6-21 
memory, corrected, 6-25 
raw data, 6-22 
ASCDATA 
example program, 8-31 
ASCH, 4-7 
ASCH encoding, 4-8 
ATN, 1-4, 1-10 
attention 
control line, 1-4 
Auto’ Feed 
plotter, 11-39 
printer, 11-33 
Autoscale., 11-14 
Aaxtozero., 11-30 
Rute 2 ON off:, 11-29 


AUX Input, 11-7 

AVERage, 12-27 

Average Factor , 11-32 
Average on-OFF , 11-32 
averaging, 6-25 

averaging status register set, 5-23 


(AVG), 11-22 


B, 11-6 

Be, 11-7 

‘Band. Pass, 11-8 

Band. Pass: Max Span, 11-3 
Bandwidth, 11-17 


Baud Rate , 11-37 
BEEPer, 12-37 

Beeper: Volume , LL42 
(BEGIN), 11-3, 12-10 


Begin: Frequency » i119 


Begin Limit., 11-19 
binary encoding, 1-4, 4-8 
<block>, 10-14 

block data, 4-5 
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block length 
definite, 4-5 
indefinite, 4-6 
block pararneters, 10-14 
blocks 
definite and indefinite length, 4-5, 4-6, 10-14 
boolean parameters, 10-12 
B/R, 11-6 


Be/Re, 11-7 
brackets 
use of in this manual, 1-3, 10-15 
branching, 10-5 
Broadband External , 11-7 


Broadband Internal, 11-7 
buifer 
graphics, 7-6 
buffering user graphics, 12-18 
bus 
data, 1-4 
bus management commands, 1-6 
byte order, 12-19 
bytes per point, during data transfer, 6-9 
byte swapping, 4-9 


c1,18 
C12, 1-8 
C2, 1-8 
03, 1-8 
C4, 1-8 
C8, 1-8 
Cable Loss , 11-28 
cables, 1-2 
(GAL), 11-28 
CAL Check , 11-25 
CALCulate, 10-4, 12-4, 12-5, 12-6, 12-7, 12-8, 12-9 
Calibrate Cable , 11-28 
calibration. ; 
full band, 12-28 
reflection, example program, 8-48 
transmission, example program, 8-46 
CALibration, 10-4, 12-10 
calibration kit 
_ exam] le program, 8-60 
Cal Kit, 11-30 
CALKIT 
example program, 8-60 
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Gal on) OFF. 11-83 
case-sensitivity, 10-8 
CATalog, 12-25 
Center, 11-8 
CHIAFWD, 6-22 
CHIBFWD, 6-22 
CHIRFWD, 6-22 
CHISCORRI, 6-24 
CHISCORR2, 6-24 
CHISCORR3, 6-24 
CHISCORR4, 6-24 
CH2AFWD, 6-22 
CH2BFWD, 6-22 
CH2RFWD, 6-22 
CH2SCORRI, 6-24 
CH2SCORR2, 6-24 
CH2SCORRS, 6-24 
CH2SCORRA, 6-24 
change directory, 12-21 
<ehar>, 10-11 
character data, 4-4 
character parameters, 10-11 
circle 

to draw, 12-18 
clear graphics, 12-18 
clearing registers, 5-4 
Clear:Program , 11-40 
clock, 11-42 
Clock Format, 11-42 


Clock Off, 11-20 
CLS, 2-6, 5-4, 10-17 
colons 

use of, 10-5, 10-16 
Color, 11-37, 11-38 
color of pen, 12-18 
Solor Options , 11-20 
command abbreviation, 10-8 
command errors, 14-3 
command parser, 1-14 
cormmands 

bus management, 1-6 

device, 1-6 

IEEE 488.2, 10-17 

overlapped, 2-3 

SCPI standard, 13-3 

sequential, 2-2 
eommand sending, 1-6 
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command tree, 10-3 
commas 

use of, 10-10, 10-16 
condition register, 5-4 
CONFigure, 12-10 
Configare VOL_RAM, 11-34 
configuring measurements, 8-7 
Connector €:, 11-29 
Connector Length, 11-29 
Connector. Model, 11-29 
Continue, 11-40 
Continuous , 11-12 
control 

passing, 3-2 
CONTrol, 12-11 
controller 

active, defined, 1-2 

defined. 1-2 

multiple, 1-7 

system, defined, 1-2 
controller capabilities, 1-9 
control lines, 1-4 
Conversion Loss., 11-6 
Copy ALL Files, 11-35 
copy file, 12-23 
Sopy. Fite’, 11-35 
corrected data arrays, 6-25 
corrected memory arrays, 6-25 
CORRection, 12-27, 12-28, 12-29 
correction arrays 

up- and down-loading, example program, 8-53 
coUuPle, 11-11 
coupling, 11-11 
Create “TSET_CAL", 11-24 
ERT Adjust, 11-43 
Current: Size’, 11-34 


Custom ‘Colors’, 11-20 
customized procedure 

exarnple program, 8-109 
Cy 118 
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D data 
block, 4-8 
character, 4-4 
expression, 4-4 
numeric, 4-3 
raw, 6-22 
string, 4-4 
Data, 11-18 
DATA, 12-40 
Data and: Memory , 11-18 
data arrays 
corrected, 6-25 
mnemonics, 6-22 
data bus, 1-4 
data encoding, 4-7 
data format, 12-19 
Data/Hem, 11-18 
Data’—> Mem’, 11-18 
Datason “OFF, 11-33 
data rate, 1-7 
data trace, 12-4 
data transfer, 4-2 
in ASCH, example program, 8-31 
in REAL format, example prograrn, 8-34 
using INTEGER format, example program, 8-38 
data transfer size, 6-9 
data types, 4-2, 4-3 
DCI, 18 
DCL, 1-10, 1-12 
Default 2, 11-20 
Default Cal:, 11-28 
Default Type-N(E), 11-30 
Define Graph, 11-39 
Define Hardcopy , 11-39 
Define: Plotter: 11-38 
Define Printer, 11-38 
Define Save:, 11-33 
definite length blocks, 4-5, 10-14 
delay 
_slectrical, 6-26 
Delay 
format, 11-22 
Delay Aperture, 11-32 
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Delete AIT Files, 11-35 
Delete: All Limits, 11-18 
Delete File, 11-35 


Delete: Linit, 11-18 
delete program, 12-25 
delimiters, 10-13 

Delta: Mir ion OFF, 11-16 


Detection Options, 11-6 
device clear, 1-10, 1-12 
device commands, 1-6 
device-specific errors, 14-12 
device status register set, 5-15 
DIAGnostic, 12-11, 12-12 
Directory Utilities’, 11.36 
direct-read method of accessing registers, 5-6 
discrete parameters, 10-11 
Disp: Freq Reeolution , 11-9 
DISPlay, 10-4, 12-15, 12-16, 12-17, 12-18, 12-19 
(DISPLAY), 11-18 
display window 
pixel coordinates, 12-18 
__Width and height, 12-18 
Distance, 11-12 
Dither , 11-13 


De CAL Check, 11-25 
double quotes 
use of, 10-13 
download an IBASIC program, 12-25 
draw 
circle, 12-18 
line, 12-18 
rectangle, 12-18 
DTR/DSR, 11-37 


E2, 1.8 

Edit Limit’, 11-19 

electrical delay, 6-26 
Jectrical Delay, 11-14 

enable register, 5-5 

encoding data, 4.2,4-7 

End Frequency , 11-19 

End Limit, 11-19 

end or identify 
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control line, 1-5 
Enhanced: Response 
eal, 11-23 
EOL, 1-5 
error coefficient arrays, 6-23 
error correction, 6-23 
error messages, 12-38, 14-2 
error queue, 1-14 
to query, 12-38 
errors 
command, 14-3 
device-specific, 14-12 
execution, 14-7 
query, 14-14 
*ESE, 5-22, 10-17 
*ESE?, 5-22, 10-17 
*ESR?, 5-22, 10-17 
event register, 5-4 
example program 
ASCDATA, 8-31 
CALKIT, 8-60 
FAST_CW , 8-42 
FAST_PRT, 8-77 
FAULT, 8-161 
GETFILE, 8-103 
GRAPHICS, 8-109 
INTDATA, 8-38 
LEARNSTR, 8-63 
LIM.FLAT, 8-140 
LIMITEST, 8-11 
LIM_MEAN, 8-147 
LIM_PEAK, 8-143 
LOADCALS, 8-53 
MARKERS, 8-20 
MBAS-SRL, 8-152 
MKR_MATH, 8-135 
PASSCTRL, 8-73 
POWERSWP, 8-16 
PRINTPLT, 8-70 
PUTFILE, 8-105 
REALDATA, 8-34 
REFLCAL, 8-48 
SAVERCL, 8-66 
SETUP, 8-8 
SMITHMER, 8-24 
SRL_SRQ, 8-156 
SRQ, 8-81 
SRQLINT , 8-85 
TRANCAL, 8-46 
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USR..PLOC, 8-165 
example programs, 8-2-1094 
execute an IBASIC cormmand, 12-25 
execution errors, 14-7 
Expand on OFF, 11-20 
expression data, 4-4 
External Point 

trigger, 1 1-12 
External Sweep 
_trigger, 11-12 
Ext. Ref-on/ OFF, 11-12 


Factory Defauit , 11-20 
FAST_CW 

example program, 8-42 
fast cw 

example program, 8-42 
FAST_PRT example program, 8-77 
FastRecall on OFF, 11-36 
FAULT ‘ 

example program, 8-161 
fault location 

example program, 8-161, 8-165 
Fault Location , 11-6 
fault location cal, 11-28 
Fault Loc Frequ: 
Fault. Window , 11-32 
Feet., 11-12 
file copy, 12-23 
File Type bin /ASCIL, 11-34 
File Utilities, 11-35 
Eime., 11-32 
Flatness, 11-16 
flatness, marker limit testing, 3-140 
font 

label, 12-18 
FORMat, 10-4, 12-19 
(FORMAT), 11-22 
Format. Disk , 11-35 
forrnat of numerics, 10-11 
formatted arrays, 6-27 
formatting, 6-27 
(FREQ), 11-8 
FREQuency, 12-31 


sy, 11-8 
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frequency, stop 

how to set, 10-10 
Frequency Sweep , 11-11 
front panel keycodes, 9-2 
Full 

IBASIC display, 11-40 
Full. ‘Band Cal., 11-28 


general status register model, 5-3 
GETFILE 

example program, 3-103 
go to local, 1-10 
graphics 

buffering, 12-18 

to clear, 12-18 

user, 7-2 
GRAPhies, 12-18 
GRAPHICS 

example program, 8-109 
graphics buffer, 7-6 
Graph: Gnly:, 11-39 
‘Graticule ON off , 11-21, 11-30 


Grey Scale, 11-20 
GTL, 1-10 


handshake lines, 1-4 
HARD COPY), 11-37 
Hardcopy A121, 11-41 
hardcopy output 

example program, 8-70 
Hardcopy Screen , 11-41 
HCOPy, 10-4, 12-20, 12-21 
Hold., 11-12 i 
Horizontal Back Porch, 11-43 
Horizontal Frnt Porch), 11-43 
Horizontal Position , 11-43 
HP S7ixC: IP Addxyess., 11-41 
HP-IB addresses, 1-2 
HP-IB cables, i-2 
HP-IE Echo, 11-41 
HP-IB queues, 1-13 
HP-IB requirements, 1-7 
‘Hue, 11-20 
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I“ TBASTC -, 11-40 


TRASIC Display, 11-40 
IBASIC, Opt. 162, 8-2 
IBASIC program 

to delete, 12-25 

to download, 12-25 

to load a value, 12-25 

to select, 12-25 
*IDN?, 10-17 
IEEE 488.2 common coramands, 10-17 
IFC, 1-4, 1-10 
Imaginary 

format, 11-22 : 
Impedance Magnitude 

format, 11-22 : 
implied mnemonics, 10-9 

how identified in this manual, 1-3 
implied variables, 10-9 

how identified in this manual, 1-3 
indefinite block length, 4-6 
indefinite length blocks, 10-14 
INITiate, 10-4, 12-21 
INITIATE, 10-9 
input queue, 1-15 
Instrument BASIC, 8-2 
Inst. State ON off, 11.33 
INTDATA 

example program, 8-38 
int Disp Intensity , 11-20 
INTeger, 4-7 
interface capabilities, 1-8 
interface clear, 1-4, 1-10 
internal 

‘trigger, 11-12 ; 
Internal 3.5" Disk, 11-34 
internal measurement arrays, 6-21 
Hnverse Video , 11-20 


L 14, 1-8 
label 
to draw, 12-18 
label font, 12-18 
GAN:, 11-41 
Landscape , 11-37 
language, 12-20 
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LEO, 1-8 
LEARNSTR 

example program, 8-63 
learn string, 12-39 

example program, 8-63 
‘Level, 11-10 
LIM.PLAT 

example program, 3-140 
LIMit, 12-4, 12-5, 12-6 
limitations 

length of HP-IB cables, 1-7 

number of devices, 1-7 
LIMITEST 

example program, 8-11 
limit fail register set, 5-16 
Limit: Icon ON-off, 11-19 
Limit Icon Position, 11-19 
Limit’ Line ON off, 11-19 
limit lines 

example program, 8-11 
Limit Teston OFF, 11-19 


Limit: Text. ON off, 11-19 
LIM.MEAN : 

example program, 8-147 
LIM.PEAK 

example program, 8-143 
ine 

to draw, 12-18 
Lin Mag:, 11-22 
Lin Mag Units, 11-22 
listener 

defined, 1-2 
List Trace Values, 11-39 
LLO, 1-11 
load a value in an IBASIC program, 12-25 
LOADCALS 

example program, 8-53 
loca] lockout, 1-11 
Log. Mag., 11-22 
Log Mag Units, 11-22 
‘Lower. 

TBASIC display, 11-40 
lower-case 

use of, 10-15 
lower-case lettering, 10-8 
Low Pass:, 11-8 
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*LRN?, 10-17, 12-39 
LRNLong?, 12-39 
Luminance:, 11-20 


Mag dBrV, 11-22 
Mag dBuV, 11-22 
Mag dBV, 11-22 
Mag. Units’, 11-22 
Manual 2, 11-29 
Manual: Zero , 11-30 
Margin: 
hardeopy, 11-38 
MARKer, 12-6, 12-7, 12-8 
MARKER }, 11-15 
Marker Punctions:, 11-16 
marker limits 
example program, 8-140 
example programs, 8-143, 8-147 
marker math 
s example program, 8-135 
Marker Math:, 11-16 
Warker —> Center , 11-16 
Marker: >: Elec: Delay, 11-16 
Marker > Reference, 11-16 
MARKERS 
example program, 8-20 
rch . 11-16 


MATH, 12-9 
Math Off, 11-16 
Maximus , 11-92 
MAXimum, 10-10 
Max Limit , 11-19 
Max Search, 11-16 
mean amplitude, marker limit testing, 8-147 
MEAS 1), 11-6 
(MEAS), 11.6 
Meas GFF, 11-7 
MEAS_SRL 

example program, 8-152 
Measure Gable , 11-28 
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Measure Connector, 11-29 
Measure Loads, 11-24 
measurement 

basic setup example program, 8-8 
measurement arrays 

internal, 6-21 
measurements 

to configure, 8-7 
measurement setup 

example program, 8-8 
Measure Qpens:, 11-24 
Measure Shorts., 11-24 
Measure’ Standard , 11-23, 11-25, 11-29 


Measure Thrus’, 11-24 
measuring status register set, 5-23 
Medium, 11-32 

Med: Narrow, 11-32 

Med Wide, 11-32 


Nemory:, 11-18 
memory allocation, 12-25 
memory arrays 

corrected, 6-25 
(HENU), 1-12 
message exchange, 1-19 
messages. 

error, 12-38, 14-2 
message transfer scheme, 1-7 
message window 

clear current, 12-16 

enable/disable, 12-16 

off, 12-16 

remove user-defined, 12-16 
_user-defined, 12-16 
Meters, 11-12 


Minimum’, 11-32 

MINimum, 10-10 

Min Limit:, 11-19 

Min ‘Search, 11-16 

Mer Limit<ON off, 11-19 


Nkr Limits, 11-19 
MKR_MATH 

example program, 8-135 
Mr —> Max, 11-16 
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Mio => Hin, 11-16 
Mir Symbol ON off, 11-39 
Ukr Table Only:, 11-39 
MMEMory, 10-4, 12-22, 12-23 
mnemonics 

implied, 10-9 

implied, how identified in this manual, 1-3 
Modify Size, 11-34 
Monochrome, 11-37, 11-38 
MultiNetch, 11-17 
Multi Peak, 11-17 
Maiti Peak Corr, 11-28 
Multi Peak Threshold, 11-28 
multiple commands, 10-7 
multiple controller capability, 1-7 
Multaport-on OFF., 11-43 
Multiport Selection, 11-7 


Marrow, 11-32 

Narrowband Internal, 11-6 
Next. Win., 11-16 

Next Peak, 11-16 

None: 

IBASIC display, 13-40 
Non-Vol RAN Bisk , 11-34 
no pending operation, 2-5 
Normalize , 11-18 
Notch, 11-17 
NPO, 2-5 
NR1, 10-11 
NR2, 10-11 
NRS, 10-11 
<num>, 10. 10 : 
Number of Foints , 11-12 
numeric data, 4-3 
numeric formats, 10-11 
numeric parameters, 10-10 
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Q offset and scale, 6-27 
One 'Port 
cal, 11-26 
<ONJOFF>, 10-12 
7OPC, 2-5, 10-17 
*OPC?, 2-5, 10-18 
Operating ‘Parameters:, 11-41 
operational status register set, 5-24 
*OPT?, 10-18 
options, 10-18 
OUTPut, 10-4, 12-23 
output queue, 1-14 
overlapped commands, 2-3 


P parallel pol, 1-11 

parameters 

block, 10-14 

boolean, 10-12 

character, 10-11 

discrete, 10-11 

numeric, 10-10 

string, 10-13 
parameter types, 10-10 
parser 

command, 1-14 
pass control, 3-2 
PASSCTRL 

example program, 8-73 
passing control, 3-2 

example program, 8-73 
*PCB, 1-12, 10-18 
peak-to-peak, marker limit testing, 8-143 
pen, 11-39 

move, 12-18 
Periodic: SelfCal , 11-24 
Phase 

format, 11-22 
Phase:Jffset , 11-14 
pixel coordinates 

display window, 12-18 
plotting and printing 

example program, 8-70 
Polar. 

format, 11-22 
Port Ext's:on QFE, 11-31 


Portrait, 11-37 


Index-17 


Power, 11-6 
POWer, 12-24, 12-83 
(POWER), 11-10 
power sweep 

example program, 8-16 
Power Sveep., 11-11 
POWERSWP. 

example program, 8-16 
PPC, 1-11 
PPD, 1-11 
PPE, 1-11 
PPU, 1-11 


PRESET), 11-2, 12-39 
Printer Address , 11-37 


Printer Hesolution:, 11-33 
printing and plotting 

example program, 8-70 
PRINTPLI 

example program, 8-70 
Print Width , 11-38 
program 

how to download, 12-25 
PROGram, 10-4, 12-25 
programming fundamentals, 1-9 
programs 

examples, 8-2-194 
*PSC, 10-18 
PUTFILE 
_ example program, 8-105 
Por Sveep. Range , 11-10 


query errors, 14-14 

query response generation, 1-15 
query the error queue, 12-38 
questionable status register set, 5-19 


queue 
error, 1-14 
input, 1-18 
output, 1-14 
queues, 1-13 
quotes 
use of, 10-13 
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R R, 11-6 


Ra, 11-7 
ratio calculations, 6-23 
raw data arrays, 6-22 
readable ports, 12-13 
Real 

format, 11-22 
REAL, 4-7 
REALDATA 

example program, 8-34 
recalling and saving 
__ example program, 8-66 
Recall Program, 11-34 


Recall State’, 11-33 


rectangle 
to draw, 12-18 


Reference Level, 11-14 


Reference Position , 11-14 
REFLCAL 

example program, 8-48 
Reflection, 11-6 
reflection cal, 11-26 
reflection calibration 
__ example program, 8-48 
Reflection Port Num, 11-7 


Refl Port Extension, 11-31 
register model 
status, 5-3 
registers, 5-2 
how to use, 5-6 
register sets, 5-10 
remote enable, 1-11 
control line, 1-5 
REN, 1-5, 1-11 
Rename File , 11-35 


Re-Save Program , 11-84 
Re~Save State, 11-33 


Response 

“cal, 11-23 
Response & Isolation. 
“eal, 11-23 
Restart Average , 11-32 
Restore Defaults 

eal, 11-23 
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RF Filter Stats, 11-16 
RF OW off, 11-10 

RL, 1-8 

ROUTe, 12-26 

RQS. 1-12 

®RST, 2-6, 10-18 

Hun’, 11-40 


Saturation, 11-20 
Save ASCIZ., 11-33 
Save AUTOST., 11-34 
Save Program, 11-34 
SAVERCL : 

example program, 8-66 
(SAVE RECALL), 11-33 
Save State, 11-33 
saving and recalling 

example program, 8-66 
eats), 11-14 
scale and offset, 6-27 
Scale/Div., 11-14 
SCPI 

defined, 10-2 
SCP] conformance, 13-2 
SCPI errors, 14-2 
SCPI standard commands, 13-3 
SDC, 1-12 | 
Search Left, 11-17 
Search Off, 11-17 
Search right. 11-17 
select a program, 12-25 
Select Copy Port , 11-37 
Select Disk’, 11-34 
selected device clear, 1-12 
Select Ttem', 11-20 
SelfCal, 12-10 
SelfCal All Ports, 11-24 
{SelfCal Once}}, 11-24 
SelfCal Timer , 11-24 
semicolons 

use of, 10-7, 10-16 
sending cornmands, 1-6 
SENSe, 10-4, 12-27, 12-28, 12-29, 12-30, 12-31, 12-82 
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sequential commands, 2-2 
serjal poll, 1-12 
service request 

control line, 1-5 


method of accessing registers, 5-7 


Set Clock , 11-42 
Set Day 

set clock, 11-42 
Set Hour 

set clock, 11-42 
Set Minute 

set clock, 11-42 
Set Month 

set clock, 11-42 
Set Pen Numbers’, 11-39 
setting the stop frequency, 10-10 
SETUP 

example program, 8-8 
Set Year 

set clock, 11-42 
SH1,18 
Show Clock, 11-20 
Single, 11-12 
single quotes 

use of, 10-13 
size 

disk, 11-34 

trace data transfer, 6-9 
Smith Chart., 11.22 
Smith Chart 20, 11-31 
SMITHMKR 

example program, 8-24 
softkey labels 

user-defined, 12-16 
SOURce, 10-4, 12-33 
spaces 

use of, 10-10, 10-16 
Span , 11-8 
SPD, 1-12 
SPE, 1-12 
Specify Length, 11-28 


Split Display FULL split , 11-20 


Spur Avoid, 11-13 
Spur Avoid Options, 11-13 
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SR1, 18 
*SRE, 10-18 
*SRE?, 10-18 
SRL, 11-6 


SRLCable ‘Scan, 11-12 
SRL cal, 11-29 
SRL example prograrns, 8-152, 8-156 
SRL_SRQ 
example program, 8-156 
SRQ, 1-5, 5-7 
example program, 8-81 
SRQ_INT 
example program, 8-85 
standard event status register, 5-3 
standard event status register set, 5-20 
Start, 11-8 
hardcopy, 11-37 
Start Distance , 11-12 
Start: Power, 11-10 


Statistics, 11-16 

STATus, 10-5, 12-24, 12-35, 12-36 
PRESet Settings, 5-25 

status byte register, 5-8, 5-12 

status register 
example program, 8-85 

status register model, 5-3 

status registers, 5-2 

*STB?, 10-19 

Step, 11-40 


Stop. 11-8 


Stop Distance , 11-12 
stop frequency 
how to set, 10-10 
Stop Power , 11-10 
<string>, 10-13 
string data, 4-4 
string parameters, 10-13 
structural return loss 
example program, 8-152, 8-156 
subsystems, 10-3 
SWaAPped, 12-19 
SWEep, 12-32 


Sweep Time. 11-11 
Sueep: Tine AUTO Man, 11-11 
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Switching Test Set, 14-43 
SHR:, 11-22 
Sync Green’ on OFF, 11-43 
synchronizing, 2-2 
syntax summary and conventions, 10-15 
SYSTem, 10-5, 12-37, 12-38, 12-39 
System Bandwidth, 11-32 
System Config, 11-42 
system controller 

defined, 1-2 
System Controlier, 11-41 
SYSTEM OPTIONS }, 11-40 


System ZO, 11-30 


T6, 1-8 
take control talker, 1-12 
talker 
defined, 1-2 
Tatker Listener , 11-41 


Target Search., 11-17 


Target Value, 11-17 
TCT, 1-12 

TEO, 1-8 

TEST, 12-39 

Test Set Cal, 11-24 
Title and: Clock:, 11-20 


Title + -Cik OW off:, 11-20, 11-39 
TRACe, 10-5, 12-40 
Trace Data OW-off, 11-39 
trace data transfer size, 6-9 
trace math, 12-9 
trace math operation, 6-26 
Tracking on OFF, 11-17 
TRANCAL 
example program, 8-46 
transferring data, 4-2 
using INTEGER format, example program, 8-38 
transferring data in ASCII 
example program, 8-31 
transferring data in REAL format 
example program, 8-34 
transform, 6-26 
transition registers, 5-4 
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Vv 


transmission cai, 11-23 

transmission calibration 
example program, 8-46 

Transmissn., 11-6 

Transmissn Port Num, 11-7 

Trans Port Extension, 11-31 

*TRG, 10-19 

Trigger:, 11-12 

TRiGger, 10-5, 12-40 

Trigger Source, 11-12 

trigger systern, 12-21 

TSet Cal on OFF, 11-38 

*TST?, 10-19 

Type=F, 11-30 

Type-NGw) , 11-30 


Upper. 

IBASIC display, 11-40 
upper-case 

use of, 10-15 
upper-case lettering, 10-8 
User BEGIN. key 

example program, 8-160, 8-165 
User Defined, 11-30 
user-defined message, 12-16 
user graphics 

example program, 8-109 
using graphics, 7-2 
USR.FLOC 

example program, 8-165 


variable 

implied, 10-9 
variables 

implied, how identified in this manual, 1-3 
Velocity Factor, 11-28, 11-31 


Vertical Back Porch, 11-43 
Vertical Frnt Porch, 11-43 
Vertical Position, 11-43 
Siew CAL Check., 11-25 
Volatile RAH Disk, 11-34 
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Ww 


FWAL, 2-5, 8-8, 10-19 
Wide, 11-32 
WINDow, 12-18, 12-19 
WINDow1, 7-2 
WINDow10, 7-2 
WINDow2, 7-2 
window geometry, 7-4 
window queries, 7-5 


X,117 
Xon/Xoff,, 11-37 
XX Ports, 11-24 
X/¥., 11-7 


Y117 

YoAxis Lbl ON off, 11.21 
Y-ixis [bl rel BS, 11-21 
Y/R, 11-7 


Z cutoff Frequency , 11-29 
Zeroing 3 8 

auto, 11-30, 12-10 

manual, 11-30 
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